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Problem : 


To Efficiently Store 
Complex Real World 
Objects in a 
Database. 


The Relational 
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Solution 


POET’s Object Oriented Solution 


= ne 


"Announcing P,O,E.T, the first true Object Oriented Database 
system for DOS, Windows, UNIX and NeXT, with prices starting 


The Affordable Database Solution. 

Up until now, object oriented DBMSs have 
typically only been available on high end UNIX 
machines, with prohibitive entry prices of 
$20,000++. Now you can unleash the power and 
potential of a true OODBMS in your DOS or 
Windows application, at prices starting at £249 
+VAT, 


Object Oriented DBMS v Relational 

Relational Database (RDBS) and B-Tree/ISAM 
systems require that data be portrayed as a series 
of two dimensional tables. These systems were a 
teal breakthrough in their time, but software 
developers are rapidly learning that life is not a 
series of two dimensional tables. 


For example, a CAD program might have an 
array of shapes, or a DTP program might model a 
page as a series of frames which might contain 
bitmaps, paragraphs or vector drawings. 
Conventional databases have a fixed set of data 
types. And the only way they group data is in a 
table. 


All trademarks acknowledged 


from just £249" 


Object-oriented programs allow us to declare new What Should You Do? 


data types as needed, And POET stores the 
Objects we create as objects. This one-to-one 
correspondence of the database design to its 
physical storage can realize access gains of over 
one hundred fold compared with relational 
DBMSs, POET has the speed while keeping its 
kernel small; the DOS runtime is under 256Kb. 


POET includes complete 
support for C++ inheritance 
and encapsulation, class: 
dictionary with class 
versioning, optimized indexing 
and querying, object caching, 
complex operators and con- 
tainers. POET has whatit takes. “ 


Persistent Object Extended database Technology 


POET took over 20 man years to develop by 
leading German Software house BKS. In non 
German speaking Europe it is distributed by 
Silicon River Limited, the same team that first 


popularized C and C++ in the UK by aggressively 


pricing Zortech C/C++. 


Silicon River Ltd 58-60 Beresford Street, LONDON, SE18 6BG 


Voice 0813177777 Fax 0813167778 BBS 081 317 2310 


> CIRCLE NO. 370 


This is the powerful, flexible database technology 
you have been awaiting. Now it is not only 
available, but affordable. If you will be developing 
a database application on any of the platforms 
below, then please call for a free Technical 
Overview of POET, the object oriented DBMS 
engine for the 1990s. 


Platforms Supported: 


Borland C++ (DOS or Windows) 
Microsoft C/C++ 7.0 (DOS or Windows) 
Zortech C++ 3.0 (DOS or Windows) 
LPIC++ (UNIX 386 Systems): 


HP C++ Softbench 
GNU C++ (NeXT Step) 


For your free POET Technical Overview call 


081 317 7777 
Biicor 


Kiver 


eee SOAPBOX See £2 


Tangled Thread 


‘Underlying every Software Engineering principle is a good idea, 
or at least the ruins of a good idea. Is this enough?’ Discuss. 


The low water mark of my programming career came in the 
autumn of 1986. Having had my dot matrix-printed ‘Threads’ 
document approved by the inspection committee, I deliberately 
and childishly spilled a mug of coffee over it in an attempt to force 
my Enemy, the Project Librarian, to reprint FFDT-1887/ded/WRW.2.7 
(as it was called) ‘nicely’ on the laser. The Librarian was having 
none of it, and it was my blotted copybook that she filed in the 
Project Cabinet where, I dare say, 
it rests to this day. 

If you have never experienced 
rampant Bad Software Engineering, 
you may have some difficulty in un- 
derstanding how I came to this 
‘Bridge Over River Kwai’ state of 
mind. (You will recall that in ‘Kwai’ 
an English POW officer, forced by 
the Japanese to build the epony- 
mous bridge, becomes obsessed 
with completing it to perfection and 
fatally loses sight of its purpose.) 

A ‘Thread’ in this context is one 
possible path of execution through 
a block of code. For example: a rou- 
tine comprising two independent IF 
statements is blessed with four 
Threads: both IF conditions False, 
IF1 True IF2 False, IF2 False IF1 True 
and both True. You get the idea. 

My Threads document described one code module, equivalent 
to 70-100 lines of Pascal. The programming involved was trivial; 
there was nothing sufficiently tricksy in it to merit the epithet 
‘algorithm’. A little data validation, a few error messages to put out 
- say an hour’s work on a good day. Each Thread required its own 
number, a data flow diagram, and an English language description 
- a short story with a dull ending. ‘Thread 27b. 1) The routine is 
called with Parameter X equal to 4, and the global 
ERR_STAT_GLOB_LHS equal to ERR_STAT_CLR_CONST. 2) The 
routine tests ERR_STAT_GLOB_LHS. 3) The routine returns. 4) No 
action is taken.’ 

Conscientious idiot that I was, I found about 60 Threads in this 
module. It was slow work. After three days of writing/drawing 
them up, I ached for a more intellectually challenging and satis- 
fying task, like washing up. The only way I managed to finish that 
document was by going Kwai: I’m going to do this thing perfectly 
- as a piece of spite to mock the stupidity of the people who are 
making me do it. 

It is easy to deduce the thinking that misled the Company to 
believe that Threads were useful. ‘To produce Quality Software’, 
says the ruins-of-ideas merchant, ‘you must document every detail 
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at every stage in baby talk, so that all ideas and components of a 
project are communicated and are traceable and are accessible by 
any member of the project who might need them. Go forth and 
write your Threads, and hang the time and the expense.’ 

But can you spot why the technique is intrinsically a load of spit? 
For here is the central paradox of bad Software Engineering. In 
order to be able to describe a module properly with a series of 
Threads, you must understand it 
completely. If you do have a com- 
plete understanding of the module, 
then the document is useless to you, 
a dangerous (because it is likely to 
be wrong or incomplete) duplica- 
tion of the code. You will quit, or fool 
around and indulge in petty coffee- 
spilling sabotage, or get promoted 
(all of these happened to me). If you 
dont have a complete under- 
standing of the module, you 
shouldn't be writing the Threads. 
You probably shouldn’t be a pro- 
grammer - but you will do it and like 
it, for what is one more incom- 
prehensible task ina working life full 
of incomprehensible tasks? 

So bad Software Engineering 
practices attract, by a process akin 
to evaporation of alcohol from 
water, bad programmers who, in turn, create bad software which 
is badly documented, 

‘What then, Mister Clever Clogs, is a Good Software Engineering 
technique? Apply the same simple rules as when evaluating a piece 
of user software for your own use. The cost of using it must be 
outweighed by its beneficial effects. These beneficial effects 
should be felt by the people practising the technique, as well as 
QA people. The technique must be simple to use. It must increase 
the possibilities of what can be done, not limit them. Some bore- 
dom is permissible; futile boredom is unforgivable. Always test 
against Occam’s razor. Try ‘programming by contract’ for an 
example which meets these criteria. 

To end the story: I fled to another job (with sighs of relief al 
round, I dare say) shortly afterwards, I don’t know if the Company, 
obsessed with enforcing its regime of documents, ever graspe' 
why it cost so much to produce so little, poor-quality software. 
Perhaps it did have an inkling. The practice of documenting 
Threads survived me, but was abandoned the next year. 


EXE! 


Will Watts edits this magazine. He won't tell us where he was 
working in 1986. 
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Summer ’87 to C 

Sequiter Software has upgraded its Code 
Translator product for converting XBASE 
applications to C. Adding to the dBASE II 
and III+ support in the previous release, 
V2.0 provides explicit support for Clipper 
Summer '87. Output is ANSI-compliant C 
which the company says will compile with 
most popular compilers including Bor- 
land C++ V3.1 and Microsoft C/C++ V7.0. 
In addition to the command-line product, 
Sequiter has provided a simple DOS text- 
based front-end to Code Translator, Code 
Translator costs £149 and is distributed in 
the UK by The Software Construction Com- 
pany on 0763 244114. 


DPMI for R:Base 
Microrim claims that it has produced the 
first DPMI-compliant relational database. 
This takes the form of R:Base V4.0 which 
offers ANSI Level 2 SQL and a new Code- 
View-like debugger with mouse support 
and multiple breakpoints. The company 
says that this release is up to 12 times faster 
than previous versions, especially transac- 
tion throughput on networks. Recent 
benchmarks conducted by InfoWorld sug- 
gest that transaction processing has been 
improved by an order of 134%. The 5-user 
version retails at £895. Phone Microrim 
on 0344 869123 for details. 


WCL 

Jules May's Catullus language (see this 
month's Mayhem) may be fictional, but 
his WCL Windows graphical language is 
real. Mr May says that his language 
greatly eases the design and implemen- 
tation of GUI programs, and he has now 
prepared a demonstration version of it, 
which can be obtained from the win- 
dev/wel conference on CIX, or by send- 
ing us a disk under the usual rules given 
on Page 3 Col 1. Mark envelopes ‘WCL’. 
You'll need a copy of MS C 6.0/7.0 and 
a Windows 3.0/3.1 SDK. Jules Computer 
Ltd is on 071 609 9677. 


dBFast Charting 

Bits Per Second is now offering a version 
of ChartBuilder for Computer Associ- 
ates’ Windows-based dBFast database. 
ChartBuilder brings charts and graphs 
to dBFast and enables developers to write 
PRG procedures which include Chart- 
Builder commands. The output from 
ChartBuilder may be displayed in a sep- 
arate window or hardcopy can be pro- 
duced using dBFast’s printing facilities. 
The package includes a royalty-free copy 
of Graphics Server, the run-time 
graphics engine used by ChartBuilder. 
ChartBuilder for dBFast retails at £49. 
Bits Per Second is on 0273 727119. 


Eubanks; Received MCI secrets 


iter and the FBI. 
Borland alleges that Eugene Wang, its fom r vice pres 
of languages, on several occasions transmitted ‘highly se: 
information’ via MCI Mail to Gordon Eubanks, CEO of Symant 
reports that Borland officials accessed Wang’s MCI accounts 
and found at least 10 such messages between Wang anc 
According to its own press release, Borland filed a 
Eubanks and Symantec, although CEO Philippe Kahn si 
Wang. A criminal investigation followed, with police | raids 0 
and the homes of Wang and Eubanks, 4 
All this occurred the day after Symantec had announced ) 
as executive vice president of Development Tools and Productivity 
manufacturer of the Zortech C++ compilers, Logitech debugg 
development tools, Symantec is a close rival of Borlar ment 
land's action, Robert Dykes, Symantec's VP of worldwide operation 
that this is an attempt by Borland to inhibit others fro: ing Be 
This activity is clearly calculated to create publicity and harass.’ 4 
During his time at Borland, Wang was noted for a very aggressive 
style, for example whipping up delegates at a Borland C++ 
of anti-Microsoft sentiment. Borland now seems to be ‘trying 
importance of Wang's role at the company and in the affair, all 
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nature of the allegations it is difficult to see how this can 


brary and supports several Adany de- 
velopment tools including Metaware High- 
C V1.73 and Phar Lap 386/ASM. The 
package also contains a copy of the Phar 
Lap DOS/386 extender. 

Other features include WIX (a windows 
manager) and GFX, a graphics supportlibrary 
which enables developers to create applica- 
tions targeted for the PC with support for 
VGA, EGA, CGA and monochrome display 
adapters. It also provides an implementation 
of TCP/IP (TNX) for network-independent 
communications and IFX, a device-inde- 
pendent I/O Manager with a hierarchical file 
system and disk caching. The VI'Xvelocity 
DOS/386 development environment retails at 
£7891. It is distributed in the UK by Instru- 
matic on 0628 476741. 


386 RTOS Toolkit 


VRTXvelocity DOS/386 is a new develop- 
ment environment for Ready System’s 
VTRX32 32-bit real time operating system. 
The package includes RT source 386, a multi- 
tasking symbolic debugger for C which pro- 
vides single stepping and conditional 
breakpoint together with multiple windows 
for displaying source code, memory dumps 
and registers. Connection to the host PC is via 
a 115,200 baud serial link. A board-level 
monitor called RTscope provides developers 
with the facility to download/upload code to 
a target system, set kernel-level breakpoints 
and view the status of the operating system, 
including the task list and queues, VRTXve- 
locity comes with a reéntrant C run-time li- 
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| icaivs. Bos tesla ee Rate, Latic, AR and Hr-Tech hosted on DOS and 
edit v’ ec, Lattice, IAR and Hi-Tech hosted on DOS ani 
|) Multi-Edit Lite DOS | WITH FULL TECHNICAL SUPPORT targeted on 280/64180, 6502, 6801, 68HC11, 6301, 
|) Multi-Edit Standard v6 DOS ' Ty 7 ASR 6809, 7811, 8051, 8096 & 68000/020. Also cross- 
| Multi-Edit Professional v6 DOS | SMALLTALK assemblers by Avocet, 2500AD, Crash Barrier (META) 
}) Norton Editor v2 DOS 1 of and IAR Systems hosted on DOS, CP/M-86 and CP/M- 
|) PVCS Prof Editor Dos | | SmalitalWV DOS 3.0 DOS £79 80 with over 30 target processors. In total over 200 
} QEdit Advanced DOS ) Smalltalk 286 286 £120 products with no space to list them here. We hold 
|) Vedit-Plus v3.5 DOS £120 | | Smalltalk PM OS2 = £280 some stock but you should allow 10-14 days for 
For more information please calll us. }) SmalltalkV Windows 2.0 Win £275 delivery. Please call for information or advice. 
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Super-duper TCP/IP 

Super-TCP is a new Windows-hosted 
connectivity tool from Diamond Point 
which enables end-users to access to 
TCP/IP networks. The product features 
multi-document E-Mail and support for 
NDIS drivers and NFS. The company 
says that it also has a real time ‘chat’ 
facility and support for several concur- 
rent TELNET sessions. Super-TCP costs 
£345. Phone Diamond point on 0634 
722398 for details. 


Mac Attack 

A market report commissioned by Apple, 
Claris and Microsoft gave evidence ofan 
alarming increase in the piracy of Mac 
software in the UK. The survey, con- 
ducted by the Ashdown Group, esti- 
mated losses of well over £20 million per 
annum - or to put it another way, for 
every legal copy of Mac software there is 
an average of 1.34 copies of illegally 
obtained software. The report has been 
published by FAST, on 0628 660377. 


Windows Over-Drive 

DFI Inc has introduced two low-cost 
Windows accelerator cards. The VG- 
8000W supports 640x480, 800x600 
and 1024x768 screen resolutions in 
256-colour mode. The VGSOOOWH ad- 
ditionally offers 1024x1024, 1024x960 
and 1280x1024 resolutions in 16-col- 
our mode. DFI says that both 16-bit 
cards increases the performance of Win- 
dows by up 16 times, The retail price for 
the VG8000W card is£119 and £135 for 
the VGS8O000WH card. DFI is on 081 
4612322. 


Hare & Tortoise 

With a sense of achievement, IBM proud- 
ly announced it had shipped the one- 
millionth copy of OS/2 V2.0. Not to be 
outdone, Microsoft counter-attacked by 
claiming it was shipping over one-mil- 
lion copies of Windows 3.1 PER MONTH. 
Will Windows run out of steam? Will 
OS/2 pick up momentum? Watch this 
space. 


Talk Windows 

Microsoft has introduced a new 16-bit 
audio card for Windows called the 
Windows Sound System. It comes com- 
plete with a microphone, headphones, 
and simple speech recognition soft- 
ware which lets a user speak Windows 
commands such as ‘File Open’ instead 
of using a mouse. Sound System is 
incompatible with other sound cards 
such as SoundBlaster. It will be avail- 
able in November and retail at £199, 
or £249 bundled with Windows 3.1. 
Microsoft is on 0234 270001. 


MOT for RDBMSs 


SysData has developed a suite of tools for 
keeping relational databases in check. The 
complete package is called CheckMate and 
includes tools for determining the logical re- 
lationships between tables, a test data gener- 
ator and a program generator for producing 
common scripts such as Cascade Delete or 
Archive Data, A key component, Smart- 
Check, is used to validate data in RDBMSs. 
This works by creating scripts to check table 
relationships and column data. SmartCheck 
generates reports and produces script files for 
repairing damaged tables. SysData says that 
running SmartCheck on a RDBMS should 
guarantee production data obeys the design 
relationships. It can also be used during sys- 
tem testing to determine whether the data- 
base behaves as expected when presented 
with test cata. CheckMate costs £4,000 from 
SysData on 071 3719191. 


BASIC for GIS 


Now AutoRoute is a brilliant bit of software. 
Haven't you ever dreamt of writing some- 
thing similar? Well here’s your chance. All 
right, I’m being a little optimistic, but a new 
language called MapBasic, from MapInfo 
Corp, may well put you on the right tracks. 
The company says that its product is the first 
to enable users to customise mapping appli- 
cations using an enhancement to the BASIC 
language which includes an extended ver- 
sion of embedded SQL. The extensions to 
SQL provide such facilities as Within, In- 
tersect and Contains for querying 
geographic databases. For instance, these 
queries enables developers to write applica- 
tions which report all customers who are 
based in a given territory boundary (eg postal 
area). MapBasic works in conjunction with 
the company’s MapInfo V2.0 product which 
is available for several platforms including 
Windows, Macintosh and Sun. The Map- 
3asic Development Environment costs 
£600. 
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Speedy R&R 


R&R Software has upgraded its existing 
range of products with new releases of R&R 
Report Writer and R&R Code Generator. Im- 
provements in Report Writer V5.0 include the 
addition of a data dictionary, ability to output 
reports in .DBF and .WKS formats, mouse 
support, and a Run-Time Query and Page 
Preview facility, The company also claims 
that V5.0 now 10 times faster than V4.0 and 
supports more database file types. V5.0 of 
R&R Code Generator is an add-on to Report 
Writer which generates code for dBASE, Clip- 
per and Fox-compatible databases. R&R Re- 
port Writer V5.0 retails at £169, with &75 for 
upgrading from V4.0. R&R Code Generator 
V5.0 costs £149 (£55 for upgrade). Phone R&R 
Software on 0628 788181 for details. 


Shareware C/C++ 


GNE C/C++ Utilities is a suite of seven 
programming tools from GNE Software Ltd. 
A Source Printer provides double-sided 
printing and printing more than one page 
per sheet, which the company says allows 
up to six pages of legible source to be 
printed on a single sheet. The Source 
Printer also provides an index which gives 
the page number of function definitions, 
headers, footers and keyword highlighting 
in bold print. 

Printer support include PostScript, Laser- 
Jet and Epson-compatibles. Other features 
of GNE include a Source Reformatter using 
user-supplied indentation styles, a Func- 
tion Prototype Generator and a Code Do- 
cumentor which extracts special 
commented text from source files to create 
alphabetically ordered function/data struc- 
ture documentation. A Call Tree Viewer 
enables developers to trace the history of 
which functions a given routine invokes or 
what function it is called by. GNE C/C++ is 
available as a Shareware product. Registra- 
tion costs £35 from GNE Software on 0582 
768341. 


for details. 


First NI Framework 


Inmark says it has beaten everyone to the mark with the first third-party application 
framework for Windows NT, Howard Love, President of Inmark added, ‘...we are the 
only vendor to provide true single source compatibility with Windows NT, Windows 
3.X, and DOS for cross-platform development.’ zApp for Windows NT needs the MS 
C/C++ compiler that comes with the Windows NT SDK. Inmark says that support for 
other compilers will be added as and when they become available. zApp for Windows 
NT costs $395 and includes full source code. 

Inmark has also announced minor upgrades to its zApp for Windows and zApp for 
DOS application frameworks. zApp for Windows V1.1f comes complete with several 
example programs to demonstrate some of the trickier features of Windows such as 
Drag-and-Drop and the use of Borland Custom Controls in Dialogs and Forms. 
Improvements to zApp for DOS V1.1f provides better source code compatibility with 
zApp for Windows. Inmark charges $10 for each upgrade. Phone 0101 415 6919000 
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RICHFORDS 
TRAINING 


C/C++ Programming Tools 


C++ FOUNDATION The bridging course for professional 
systems developers with no C experience. 


C++ PROGRAMMING Both courses have been designed for 
experienced C programmers who are 
C++ for WINDOWS working for software or systems houses. 


All courses are designed and written by developers, 
for developers in the real world. Our training is also 
available on-site, tailored to clients’ specific 
requirements. In addition to our published schedule, 
Richfords hosts advanced technical seminars and 
problem-solving workshops. 


cuLNow — | RICHFORDS 


CURRENT SOUTH BANK TECHNOPARK 90 LONDON ROAD 


LONDON SEI 6LN 
SCHEDULE 
TELEPHONE 071 922 8819 


All trademarks acknowledged 


Put an end fo software piracy! 


Meet the growing family of security keys 
from Software Security. 


Each one a specialist at enforcing your 
license agreement in virtually any user 
environment you can think of. Whether it's 
DOS, UNIX, Macintosh or OS/2... whether 
it's a single user installation or a LAN. 


THE ULTIMATE 
PROTECTION 
FOR SOFTWARE 
PUBLISHERS 


Ail product names are trademarks or registered trademarks of their respective holders. 


Simply connect the appropriate key to a 
single user computer, or a non-dedicated 
file server in a network, and you control all 
access to your protected application. 


Users, however, won't even know it's there. 
The keys are transparent and won't 
impact software functionality or the ability 
to make back up copies. Normal node 
and LAN operations are unaffected. 
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Simple. Unassuming, Ever vigilant. Easy to 
incorporate into your application 
package. And quite possibly the most 
profitable hardware investment a 
software developer can make. 


To find out more, call: 


(0784) 430060 _ 


Software Security International Ltd 


21a The Precinct, High Street, Egham, Surrey, United Kingdom, TW20 9HN 
National telephone: Egham (0784) 430060 fax: (0784) 430050 International telephone: +44 784 430060 fox: +44 784 430050 
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$50. 


deck on 0245 496699 for details. 


SDK for DESQView/X 


In an attempt to steal some limelight away from NT and OS/2, Quaterdeck is 
pulling all the stops to spread the word on the recently introduce DESQView/X 
system. On the heels of the Santa Monica Developer's conference in August, and 
having announced that a European conference is in the pipeline, the company has 
released a number of SDKs for DESQView/X. The X11 toolkit gives developers 
access to scalable fonts via Adobe Type Manager, and the ability to create X client 
applications. The toolkit also includes an implementation of the Berkeley Socket 
Interface for network-independent communications, and allows developers to 
access DLIs, remote printing, and virtual memory provided by DESQView/X. As 
an added incentive, a Starter Kit is available which includes the GNU C/C++ 
compiler, the X11 R4 programming libraries and the X System libraries at a cost of 


The complete X11 Toolkit adds support for several C and C++ compilers (including 
MS Cand Borland C++) and includes Oxygen, the Instant C development environment, 
and Quaterdeck’s Developer Passport support. The Toolkit costs $750. Phone Quater- 


Power to Windows 


Turbo Power's Win/Sys is a new Windows 
DLL for Borland C++, Microsoft C/C++ and 
Turbo Pascal for Windows which provides 
developers with string, date/time manipula- 
tion routines, huge arrays of up to 64 MB in 
size, and a number of container classes in- 
cluding stacks, queues, binary trees and hash 
tables. There is also a non-recursive Quick 
Sort routine and DPMI access to TSRs or DOS 
memory from within Windows. Additional 
DOS support includes access to BIOS and 
DOS environment variables. Win/Sys also 
provides built-in error-trapping for run-time 
errors such as Divide-by-Zero or General- 
Protection-Fault. A Heap Analysis tool is in- 
cluded which generates reports showing 
memory usage during execution of an appli- 
cation. Win/Sys is priced at $149 and includes 
complete source code and documentation. 

Turbo Power has also released another 
Windows development tool. The Data Entry 
Workshop for Borland’s Resource Workshop 
enables developers to create forms with vali- 
dated data entry interactively. The library sup- 
ports all standard C++/Pascal data types and 
also includes ‘hooks’ for user-defined types. 
A utility called Makesre converts the forms 
into Pascal/C++ source using a source code 
template that can be modified by the de- 
veloper. The new data-validated controls ap- 
pear as objects which can be accessed from 
the Borland Object Windows Library applica- 
tion framework. Data Entry Workshop sup- 
ports Turbo Pascal for Windows, Borland 
C++ and Turbo C++ for Windows. It retails at 
$189 and includes complete source code. 
Turbo Power is on 0101 719 2609136. 


Events for SuperBase 


Version 2.0 of Superbase, the Windows- 
hosted RDBMS from Software Publishing 
Corporation (SPC), has been shipped. En- 
hancements to Superbase’s programming 


language, Super Basic include Visual Basic- 
like event-handling, user-defined functions 
and an improved editor with online Help. 
V2.0 also supports Windows 3.1 features 
such as OLE, and MCI and it can import/ex- 
port to Paradox and dBASE databases. 
There is also a new BLOB (Binary Large 
OBject) facility. The Developer's Edition of 
Superbase includes a new release of the 
Superbase SQL Library (V1.1) which en- 
ables data to be exchanged with several 
SQL engines including Oracle Server, 
Microsoft SQLServer and Gupta SQLBase. 
The rapid application development envi- 
ronment has been enhanced to include 
point-and-click Query-by-Example and a 
macro recorder, The price of the De- 
veloper’s Edition is &995, and includes 
Superbase SQL library V1.1, Superbase 
Run-Time System and an unlimited licence 
to distribute Superbase run-time applica- 
tions. SPC is on 0344 867100. 


BC31/C7.0 Debugger 


Only months after the July buy-out of 
MultiScope Inc, Symantec has announced 
MultiScope debugger V2.0. This release of 
the Windows-based C++ debugger pro- 
vides support for Borland and Microsoft 
C++ compilers. Along with a Windows- 
hosted GUI and C++ name unmangling, 
other features of MultiScope include object- 
oriented breakpoints for specifying break- 
points on C++ methods directly, and a class 
browser. It fully supports C++ expression 
evaluation and enables the programmer to 
navigate through the source code using the 
Class Browser to select member functions 
to view. 

In addition to providing run-time de- 
bugging support, MultiScope includes a 
post-mortem debugger called the Crash 
Analyser System. At &499, Multiscope is 
targeted at the higher end of the market. 
Symantec is on 0628 776343. 


Local Heaps 

Library Technologies’ C-Heap, fea- 
tured in .EXE April ’92, is in its third 
release. V3.0 adds local heaps and ad- 
ditional expanded memory routines to 
the memory management facilities of- 
fered by previous releases. The com- 
pany suggests one usage of local heaps 
could be to store a given instance of a 
C++ class. The local heap can be 
swapped in and out of conventional 
memory to make room for other ob- 
jects. C-Heap V3.0 costs $229. Library 
Technologies is in the US on 0101608 
2744224, 


CIX without tears 

There are three big drawbacks to elec- 
tronic conferencing systems: they are ex- 
pensive, theirarchaic user interfaces are 
clumsy and hard to learn, and a huge 
proportion of their content is self-indul- 
gent, cliquish tosh. WIGWAM for CIX, 

JSrom Ashmount Research, is a Windows 
program which addresses the first two of 
these problems, WIGWAM is an ‘Offline 
Reader’ - it downloads all your messages 
in one go, and holds them in indexed 
files on your hard disk. All message read- 
ing, editing etc can take place offline (= 
Jor free) using WIGWAM's pleasant user 
interface. It also handles file up/down- 
loading, and seems to provide access 
to all the CIX features that one could 
wish. The price is £145, Ashmount Re- 
search is on 071 935 7712, 


PC X-Server 

NCD's PC-Xview enables networked PCs 
to be run as colour X terminals. The 
latest release (V4.0) of this X windows 
system server supports Path Works from 
Digital, giving users concurrent access 
to DECnet and TCP/IP. Other new fea- 
tures include support for XGA and local 
windows management which the com- 
pany says provides better performance. 
PC-Xview costs £350 per user and is 
distributed in the UK by Unipalm on 
0223 420002. 


How much, squire? 

It's not easy estimating the cost of pro- 
ducing an application for a customer. 
General Electric (US) has come up with 
4 tool to help. Called Price S, it takes as 
input several factors including the mag- 
nitude of the project, complexity, the 
ability to reuse existing code, and out- 
puts cost reports, schedules and a cost 
risk analysis. Price S is available for 
MS-Windows and OSE/Motif. A single 
user annual licence costs £9500. It is 
marketed in the UK by Price Systems on 
0256 760012. 
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Letters 


We welcome short letters on any subject that is relevant to software development. Please write to 
The Editor, .EXE Magazine, 10 Barley Mow Passage, Chiswick, London W4 4PH. Unless your letter is 
marked ‘Not for Publication’, it will be considered for inclusion in this section. 


A Change of Address 


Dear Mrs Adams, (Mrs Adams runs our 


subscription database - Ed) 

Three years ago, in June 1989, I wrote to 
you to cancel my subscription to EXE ma- 
gazine. I explained that the subscription 
rate for your magazine was 40% of my 
monthly income. You generously offered 
me a free subscription to .EXE until my 
financial situation improved. I accepted, 
hoping that it would be for a year, or, at 
worst, two. 

A year later, the first free elections came, 
and the restis history. Imustadmit that never 
thought I would experience a war in my life. 
I have been very lucky: my family has not 
suffered any loss, and our home has remained 
intact. The front stopped near Novska. Kuti- 
na, a town of about 25,000 people, is 30 
kilometres from Novska towards Zagreb. 
Apart from the numerous air raid warnings 
and two aircraft attacks (the first on 31st Oc- 
tober killed two people, the second de- 
stroyed a factory on New Year's Eve), our 
town has been untouched by the fighting. 

_ But one of the many consequences of the 
war has been a fall in the standard of living. 
Inow earn about £35 per month, which isn’t 
even enough to cover one year’s subscrip- 
tion to .EXE magazine. 

Ihave now received .EXE free for three full 
years. Because of this, I have to suggest that 
you stop sending me your magazine until I 
can afford to pay, and that could be a while. 
Also, if you feel that the duration of my free 
subscription was too long, I will gladly pay 
whatever you think is due. You will have to 
send me a bill, since the bank won't allow 
overseas payment without an invoice. 

Finally, I must inform you of a change to 
my address. I now live in the Republic of 
Croatia, not Yugoslavia. 


Zlato Smrcek 

Kutina 

Republic of Croatia 

Needless to say, Mrs Adams will not be 
issuing any retrospective invoices, and 
hopes to persuade Mr Smrcek to continue 
his free subscription. Sorry for the self-ad- 
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vertisement, but I thought this letter might 
help put the recession in perspective - Ed. 


Nintendo returns 


Sir, 

With development work in even some 
large IT departments having ground to a 
halt, perhaps the recession will provide a 
silver lining in the form of giving IBM brea- 
thing space to try for ‘third time lucky’: OS/2 
V3.0. V2.0, like V1.0, requires either inordi- 
nate reliance on a third-party CASE vendor 
or use of a tax loss acquisition to develop 
any significant software. 

It is certainly a pity that no silver lining 
has appeared in the form of flushing out of 
the computer industry those who send hate 
mail, which I was sorry to hear you received 
after publishing my ‘Nintendo’ letter (EXE, 
April '92) directed against Cult) pro- 
grammers and Windows fetishists. 

Roland Hitchcott 
Hampshire 


Windows Editor #1 


Sir, 

I was surprised and disappointed by the 
tone and contradictory style of Jules May’s 
review of Windows editors in the Septem- 
ber issue of .EXE magazine. I venture to 
suggest that Mr May’s opinion of ED is far 
from representative of the vast majority of 
users, and other reviewers for that matter. 

First, response from our many hundreds 
of customers could not be any more posi- 
tive. Furthermore, ED for Windows has just 
won the PC92/PC Week ‘Best New Soft- 
ware Award’ for 1992 and in the same week 
received very good reviews in both PC 
Week and Windows Tech Journal. Of 
course, Mr May does make some valid criti- 
cisms, and a new release is due out in 
September addressing some of his com- 
ments and adding new functionality. 

In closing, I feel that if there was one 
thing the article accomplished, it was to 
prove that the only good editor in the 
author's eyes was likely to be one he wrote 


himself. In my view it was a questionable 

article to be printed in a magazine I usually 
regard to be of the highest standard. 

Neville Franks 

Managing Director 

Soft As It Gets P/L 


Windows Editor #2 
Sir, 

I have just read Jules May's review of 
Windows editors in your September edi- 
tion, and I would like to point out several 
careless, factual errors. 

‘Although the [ix] standard installer didn’t 
set it up... you can add another menu item 
to handle folds...’ On the utilities 
menu are the options; fold, fold all 
and unfold all, all installed by the 
standard installer. As Mr May so rightly 
points out, this is not in exact agreement 
with the manual, but they are readily avail- 
able in ix’s standard configuration. 

‘Smart indenting cannot be switched off 
(and is brain-damaged)...’ The standard 
identation assigned to the return key is 
the editor function EditKRSplitLine after the 
style of Kernigan and Ritchie (which might 
not be Mr May’s style but is certainly not 
‘brain-damaged’). It can be changed for 
EditMJSplitLine or turned off completely by 
using EditSplitLine. 

‘Ix (sic) won’t compile [using a third-party 
compiler] at all (despite having a menu item 
to do so)...’ When this menu item is high- 
lighted the status bar reads ‘Compile the 
current (AdHoc) file’ which it does without 
problem. One can only expect menu items 
to do what they are designed to do. 

‘Since there’s no keystroke to get to the 
left margin, there’s no statement to do it 
either.’ home moves to the first non-blank 
character on a line and ctrl-home 
moves to the very start of a line and there 
are statements for both. And further, there 
are, in fact, many editor functions which are 
not merely menu items ‘given a name and 
stuck in the language’. 

“You can’t find out if there is a selection...’ 
The obviously named EditIsSel func- 


Goldstar 
Professional PCs 
Fully Featured ccs 
at unmatched price: 
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PRICES FROM 


£499. 


If you want a low cost, 
quality PC system then look 
no further. Silica have the 
answer, with the range of 
GoldStar computers that are 
featured on this page. Each 
model comes with a range 
of features as standard (see 
panel to the right), including 
a 14" S-VGA .39mm dot 
pitch colour monitor and a 
40mp hard disk drive. 


All GoldStar models are 
expandable and are fully 
supported by Silica's own 
Technical Helpline and also 
by GoldStar's 1 year on-site 
warranty. Contact Silica now 
for your low cost, quality PC 
system solution. 


@S-VGA COLOUR MONITOR 


14' GS1453 1024x768 S-VGA .39mm Dot Pitch 


© 40mb HARD DISK DRIVE 
@ 3%" FLOPPY DISK DRIVE 
© VGA GRAPHICS 
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PS/2 MOUSE PORT 
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SYSTEM SHOWN HERE 
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WINDOWS 3.1 & 

PS/2 MOUSE 


OPTIONAL EXTRAS 
2mpb RAM UPGRADE = £25.var 


Memory upgrade from 1Mb to 2Mb - Ref: MEM 3709 


4mp RAM UPGRADE = £50.var 


Memory upgrade from 2Mb to 4Mb - Ref: MEM 3709 (x2) 


2nd FLOPPY DRIVE - £45.var 


Second 5%' floppy disk drive - Ref: DRI 9752 


WINDOWS 3.1 + MOUSE = £45,var 


Windows 3.1 + PS/2 mouse - Ref: KIT 4426 


130mb HARD DISK = £100.var 


130Mb hard disk upgrade (instead of 40Mb) ~ Ref: HAR 2905 


CD-ROM DRIVE = £200,var 


CD-ROM drive + free illustrated encyclopedia disc - Ref: CDR 2120 


MONITOR UPGRADE - £40.var 


Colour monitor upgrade from .39mm GS1453 to .28mm GS1460 
MPR II 1024x768 with low radiation - Ref: MON 6784 


@ FREE OVERNIGHT DELIVERY: On all hardware orders shipped in the UK mainland. 

@ TECHNICAL SUPPORT HELPLINE: Team of technical experts at your service. 
PRICE MATCH: We normally match competitors on a “Same product - Same price” basis. 
ESTABLISHED 14 YEARS: Proven track record in professional computer sales. 


£12 MILLION TURNOVER (with 60 staff): Solid, reliable and profitable. 


BUSINESS + EDUCATION + GOVERNMENT: Volume discounts available 081-308 0888. 
SHOWROOMS: Demonstration and training facilities at our London & Sidcup branches. 


THE FULL STOCK RANGE: Allof your requirements from one supplier. 


FREE CATALOGUES: Will be mailed to you with offers + software and peripheral details. | 


PAYMENT: Major credit cards, cash, cheque or monthly terms. 


Before you decide when to buy your new computer, we suggest you think very carefully about WHERE 
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GPC 2123 + MON 6753 


GPC 3163 + MON 6753 


GPC 3183 + MON 6753 


GPC 3253 + MON 6753 


GPC 4804 + MON 6753 


MAIL ORDER: 1-4 The Mews, Hatherley Rd, Sidcup, Kent, DA14 4DX Tel: 081-309 1111 
‘Order Linés Open: Mon-Sat_9.,00am-6.00pm No Late Night Opening Fax No: 081-308 0608 


LONDON SHOP: §2 Tottenham Court Road, London, W1P OBA Tel: 071-580 4000 
‘Opening Hours: Mon-Sat 9.30am-6,00pm No Late Night Opening Fax No: 071-323 4737 
LONDON SHOP: Selfridges (ist Floor), Oxford Street, London, W1A 1AB Tel: 071-629 1234 


Opening Hours: Mon-Sat 9.90am-6.00pm Late Night: Thursday until 8pm Extonsion: 3914 


SIDCUP SHOP: 1-4 The Mews, Hatherley Rd, Sidcup, Kent, DA14 4DX Tel: 081-302 8811 
‘Opening Hours: Mon-Sat 9.00am-5.30pm. Late Night: Friday until 7pm Fax No: 081-309 0017 


PLEASE SEND INFORMATION ON GOLDSTAR PC SYSTEMS 3 


you buy it. Consider what it will be like a few months after you have made your purchase, when you may Mi/Mirs/Miss/Ms° «0... Initials... SUMAME: 88 | 
require additional peripherals and software, or help and advice with your new purchase. And, will the i SLi . 
company you buy from contact you with details of new products? At Silica Systems, we ensure that you Company Name (if applicable): - 
will have nothing to worry about. We have been established for almost 14 years and, with our unrivalled | 
experience and expertise, we can now claim to meet our customers’ requirements with an understanding AddrOSS: secssssnesssrserseesnssesoranesen 2 
which is second to none. But don't just take our word for it. Complete and return the coupon now for our 
latest FREE literature and begin to experience the “Silica Systems Service’. 

SILICA ouvsaenh Postcode: | 
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EXHIBITION AND 


OFTDEV9? 


CONFERENCE 


24th - 26th November 1992, 
The Conference Forum, Business Design Centre, London. 


Do you need to keep ahead of the latest advances in the development world, are you responsible for strategic decisions 


concerning systems development? 


Organised By 


EXE 
MANAGEMENT 


The SoftDev 92 Conference is the definitive forum for discussion and debate on issues surrounding and concerning 


Software Development. 


Three streams and over 60 speakers will present developers and managers alike with a clear view of the current and 
future states of the development market, introduce them to new techniques, tools and methodologies. 


Issues discussed will range from OOP to Open Systems, C to C++, Unix to User Interfaces, Networking to NT. 
Everyone in the software development market must attend this conference. 


Running concurrently with the conference is the SoftDev Exhibition, where attendees will get hands-on access to new 
software releases and real no-nonsense information from key software manufacturers and vendors. 


Writing Win16 applications to port to Win32 
The Win82 API is your link between Windows 3.x 
and NT. Here’s what you need to know to write 
applications that will run on both platforms. 
Win32 Extensions to the API 

Which API calls to use and which to avoid when 
writing portable Windows code. 

Implementing OLE in your applications. 
Object Linking and Embedding allows your program 
to exchange data with any other Windows 
application. Here's how to code it. 


Undocumented Windows. 

Hidden in the depths of the Windows kernel are a 
number of API calls & data structures, originally 
designed for use by Microsoft's own developers. 
Building and Writing Custom Controls. 

It takes a mixture of C, Assembly Language and 
Basic to write custom controls for VB. Confused?... 
We'll show you the solution. 

Writing Dynamic Link Libraries 

DLLs let you share code between multiple VB 
applications, or multiple instances of a single 
application. Here’s how to write them. 
Debugging Tools for Windows 

A survey of what's available and the facilities they 
offer, plus advice on how to choose the one that 
best suits your needs. 


The need for Low Cost CASE 

A modular approach to the design and use of CASE 
tools will reduce the initial financial outlay on CASE 
software and in future enable users to purchase only 
those modules which they need. 

Adding Value to low Cost CASE 

Using low cost CASE tools throughout the 
development cycle to enhance and accelerate 
accurate design and development. 

The Case for Process Management 

The evolution of Process Management through to 
the benefits of Process Modelling. 

People Make Systems Work - Not tools. 
Involving the right people at each stage of the dev- 
elopment process can have a more profound effect 
on quality & productivity than many CASE tools. 


The Impact of CASE on Quality Systems 
Can CASE increase the quality of software as well 
as easing the design and development path? 


CASE - the Next Generation 

The next generation of CASE tools resulting from an 
understanding of the interaction between analysts 
and designers will offer a step function improvement 
in productivity. 

Rapid Application Development 

The revolutionary potential of RAD to break the 
development backlog by increasing productivity, and 
the steps which developers should take in its 
introduction. 


Development of xBase GUIs Using a 
Structured Methodology 

Developing the use of common routines and 
methods to achieve the same results across the 
entire range of xBase products. 

Run with The Fox 

The 1992 xBase sell-off has left Microsoft in control 
of one of the most popular and powerful packages. 
Whither now ? What else do Microsoft have under 
their belts ? 

Running an xBase System under UNIX 
Implications of porting an xBase application from a 
single tasking operating system to the more 
advanced and flexible world of UNIX 

Designing for Multiple Back Ends using 
objects 

How to design a systems, using objects, with the 
ability to talk to DBFs, SQL, Btrieve and other 
database management systems. 

Setting the ANSI xBase standards 

The complications and the implications will be 
discussed. 

The Future of Clipper 

Now 'Under new Management’, will Clipper's 
development follow the path set out by Nantucket? 
What new features and functionality can we expect ? 
Extending the dBase Language 

Borland’s strategy for the dBase of the future and 
the xBase standards. Including how to make the 
best use of the existing dBase language with a 
discussion on programming techniques. 


Essential Techniques for Object Oriented 
Design 

Presents a set of techniques with a consistent and 
fully object-oriented interpretation, building on 
familiar notations and ideas with a completely 
practical focus. 


Object Based Design in SSADM 

The first step towards object-orlentation for 
transaction processing, enabling major business 
systems to be re-written as integrated and flexible 
sets of applications. 


Object Oriented - The Missed Opportunity 
0-0 is a general problem-solving technique that has 
short-sightedly been used for software development, 
when it can be used for general business problem 
solving: corporate business modelling, human task 
modelling and more. 


Object Oriented Metrics 

Implementing OOP raises project management 
issues like planning, control and estimating within an 
evolutionary life cycle. Therefore new methods of 
measurement are necessary to predict design and 
coding effort. 

0-0 Analysis & Recursive Development 
O-OA/RD provides a uniform approach to the 
analysis of problem domains and architectural 
domains by aiding the selection of a global set of 
rules rather than the adaptation of individual code 
modules. 

OOP ona Palm Top 

A case history of Psion's experience in 
implementing class libraries and in writing 
applications using OOP. 


Choosing a 4GL 

The concepts and benefits of using 4GLs in 
commercial software development environments. An 
overview of some leading products highlights the 
benefits and pitfalls of each product and how these 
relate to the users. 


Version Control & Configuration Management 
An overview of version control and configuration 
management, relating them to current practices in 
development management. 


Choosing a Client Server System 

This presentation aims to define both the business 
benefits from Client Server computing, and the 
important decisions in their implication. 

Is Client Server Computing Ready for Prime 
Time? 

Assesses the current state of client server 
technology and its readiness for ‘prime-time’ use by 
developers, as a platform for RDBMS, LAN use etc. 
Getting your VAX together 

Project management is an undervalued and under- 
used discipline. This talk examines techniques such 
as critical path analysis and resource scheduling 
and discusses the impact of Project Management. 
Quality Assurance - Modern Techniques 

QA is not a dirty subject. Using QA techniques can 
ensure that you produce consistently good, easily 
maintained code. 


Developing OS/2 Workplace Shell Objects 
Programming with the System Object Model (SOM) 
to develop class libraries and object-oriented 
programs. 

Introduction to the Presentation Manager API 
Focussing on PM API functions found in OS/2 2.0 
and a discussion of 32 bit migration calls. 
Overview of OS/2 Development Tools 

Looking at the variety of tools available, particularly 
those for which 32-bit announcements have been 
made. 

OS/2 As A Development Platform 

What does OS/2 2.0 offer as a development 
environment? The av alietee of using OS/2 even 
for development for other platforms. 

Cross platform development with OS/2 2.0 
Exploring issues, techniques and advantages of 


using OS/2 as the development platform for all 
environments. 


Designing OS/2 Applications 

Writing good programs for OS/2 requires a new way 
of thinking, but in the long run it will be easier than 
developing for DOS. 

New Presentation Manager Features 

New object types are discussed and demonstrated 
together with programming examples. We will show 
you how PM provides an object oriented 
programming environment beyond the visual 
elements of an application. 


Licence Management for Open Systems 
The use of Licence Managers and their integration 
into applications to ensure that both the customer 
and developer benefits are maintained. 
Choosing a 4GL for Open Systems 

How a system-specific 3GL user can choose 
between apparently highly similar 4GLs for an open 
system. 

Networks and the Client Server Architecture 
The applications of client/server systems, how to 
integrate them into existing networks and their 
impact on data strategy. 

Security and Risk Management . 

Maintaining security over disparate open systems. 
Inside LAN Manager 

The current and future direction for LAN Manager, 
and how it fits into a enterprise wide networking 
strategy. 

Distributed System Management 

Maintaining a wide-scale system, including data 
concurrency and access control. What tools are 
available to manage these systems? 

Gupta’s SQL System - 

Delivering Client/Server solutions. 

Designing and maintaining a SQL database system, 
and how it can be used to provide multi-platform 
data access. 


VB 2 Presentation 

A first look at the latest version of Visual Basic for 
windows. Also some insights into Microsoft's plans 
for future versions of Basic under both DOS and 
Windows 

Porting between VB for DOS and VB for 
Windows 

what features should you avoid, and which ones 
should you use in order to write code that can be 
easily transferred between the two versions of 
Visual Basic 

Increasing Speed and decreasing code size 
Tips and tricks to help keep your .EXE files as small 
as possible whilst creating the most efficiently coded 
programs. 

Extending Visual Basic 

Using VB to front-end both Windows and DOS 
applications, using DDE, OLE and calls to .DDLs 
Linking Basic with other languages 

How to have your cake and eat it. Everything you 
need to know to link routines created with C, Turbo 
Pascal, Assembly language and other languages 
into your Basic program. 

How to write Libraries and Add ons 

Writing and managing .LIB, .QBL and other library 
files to help you make the most efficient use of the 
Basic environment without having to re-invent the 
wheel. 

Debugging Basic Programs 

How to use CodeView, Turbo Debugger, SoftICE 
and Basic itself to prevent and detect errors in your 
programs. 


PLEASE FILL IN THE FORM BELOW IF YOU 
WOULD LIKE TO REGISTER FOR ANY OF THE’ 
STREAMS MENTIONED ABOVE. 
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Ed — the one stop programming productivity tool 


¢ Supports C, C++, dBase, Clipper, Pascal ete. ¢ Other emulations supplied: Brief, Qedit & Norton 
¢ Code completion ¢ Automatic indentation & formatting 

¢ Templates for functions, statements and declarations ¢ File sizes up to 100MB 

¢ Error tracking for many different languages ¢ Unlimited undo & redo 

¢ Function/procedure look-ups and listing ¢ Full Search & Replace 

¢ Keyboard and programmable macros ¢ Line, stream & block marking 

¢ Keyboard remapping — for favourite keystrokes ¢ LAN file locking, individual configurations 


European distributor: QBS Software Limited, 10 Barley Mow Passage, Chiswick, London W4 4PH 
Tel: +44 81 994 4842 Fax: +44 81 994 3441 BBS: +44 81 747 1979 
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tion returns 1 if there is a selection and 0 
otherwise, or use EditGetText to re- 
turn the text of the current selection. 

The review started in error (the product 
is called ‘ix’ not ‘Ix’ and ended likewise (it 
is priced at £95 not £99.95) and gives every 
indication of having been written without 
reference to the manual and with only the 
briefest exposure of the product. 

Andrew Horton 

Positive Lid 

The ix/Ix business is an editing fault, not Jules 
May’s. My apologies for this. Here is Mr May's 
reply to Mr Franks’ and Mr Horton's comments: 

Tcan understand that ED has many satis 
Jied users, and also that PC Magazine liked it. 
ButI didn't. Lexpected to like it. lwanted to like 
it. Leven tried to like it, but after several weeks 


of use, like it I did not, I stopped short of 


apologising for not liking it. 

‘Ttried very hard to befair to ED’s good points, 
Even if I do not like it, EXE readers should be 
able to make their own assessment from what 
Ihave written, and decide for themselves. 

‘Having said that, I deeply resent Mr Frank's 
implication that anyone who doesn’t like ED is 
unfit to pass an opinion. I know you need to 
have a pride in your accomplishments, but 
really! 

‘ix is a different case. Mr Horton accuses 
me of factual errors, For his information, the 


[olds did not appear on the menu, neither 


Six 


where the manuals said they should, nor 
where he now claims they did. 1 still have 
the original disk and have checked. The 
smart-indentingis brain-damaged, it takes 
no account of whitespace or comments, and 
it won't outdent. 

‘ix calls compiling "making" and macro 
compiling "compiling". Perhaps this is the 
reason for Mr Horton’s considerable confu- 
sion - during my testing, be confirmed to me 
the problem with compiling (excuse me, mak- 
ing) on the phone - it was one of the many 
occasions when he promised me an update to 


‘Mr Horton is right about ct r1-home . 
The function is called EditLineStart. 
You can discover that the ct r1-home-key 
is assigned to this, but not vice versa. He's also 
right about EditIsSel. I searched for 
something like this - now it bas been pointed 
out, | found it between EditSa- 
veAsStr (FileName) and EditSet- 
SearchStr (String). Thanks for 
nothing. 

‘As to the business of editor functions: Iwent 
through the function directory in the manual, 
counting the functions which were either in 
the ment. or attached to a key (77), those 
which were not (1), and those which couldn't 
be (14). I think these figures speak for them- 


Letters 


selves - most functions take no parameters 
and yield no results, and all but one of these 
is a keystroke or a menu command. (The 
one, incidentally, is EditMJSplitLine). 
‘After seeing your program, Positive, I 
think that it’s more than a bit rich for you 
to accuse anyone of carelessness. Your pro- 
gram is half-finished, it has been like that 


Jor the last year, and Idon't think you care.’ 


Windows Editor #3 


Sir, 

Well, Mr May, I'm sorry you don't like ED 
for Windows - | and many others do. If any 
of .EXE’s readers would like to find out for 
themselves, call us on 081 9944842 fora free 
working demo. 

Tan Butterworth 
QBS Software 
That's quite enough ED - Ed. 


Letter of the Month 


The writer of the best letter of the 
month, as judged by the Editor, will 
receive a £20 book voucher, courtesy 
of Just Computer Books. The best letter 
is the one printed first. Please note 
that letters submitted to this page may 
be edited. 
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Tim Wool 
FTN77/386 User. 
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Dr. GR. Chaplain 
NCL Invesiments Lid. 


“The debugger was very easy lo use. There 
is an on-line help facility, which made 
reference to the manual unnecessary. 

.. Mike Gunn and Arul Britto, 
EXE Magazine, May 1989. 
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VVX————————————— a 2 


vcs 


Big Brother 


‘Warning: you are entering a no-fun zone.’ When the Editor decided .EXE should do 
a comparative review of version control systems, Cliff Saran was last to the door... 


Here’s a grim scenario. Imagine you are the 
project manager for a large software project 
consisting of a team of eight or so pro- 
grammers. What would happen if source 
code created by one programmer was over- 
written by another? Without some way of 
preventing a source file from being edited 
by more than one individual at the same time, 
this could easily occur. This is where a version 
control system comes into play - enabling 
several programmers to work, in parallel, on 
different components of a software project. 


As an added bonus it also logs modifica- 
tions made to source files, providing a 
means of tracking-down where and when 
a given bug was introduced. 


Indeed, with the comprehensive report gen- 
erators of modern version control systems, 
detailing not only who mace a given change, 
but also the number of source code lines that 
were altered and how long it took, the less 
scrupulous project managers can easily 
check-up on who's been putting in the hours. 


9K SMS Pvcs 
Type of VCS Single-user Multi-user Multi-user 
only 
Platforms Supported | DOS bos, DOS, 
os/2, os/2, 
UNIX UNIX 
Front-End Text-based Text-based Windows-hosted 
Keyboard-only Mouse-driven z 
Editor Support Built-in Invokes user PWB 
File-viewer supplied editor PVCS Prof Edit 
from front-end + others 
Command-line V4 NV, ns 
Slow Extra care Needs VCS.CFG 
with new files contig file 
VCS Directives N 1 8 
Help System Context Context N 
sensitive sensitive 
Report Generator Interactive Batch-mode Batch-mode 
Fixed-format User-supplied User-supplied 
Audit-trail 
Configuration N Build and Available 
Management Autobuild separately 
Special Features Built-in Modification Promotion 
support for Request Model project 
xBASE .DBF facility lifecycle 
Manufacturer Forté Software IntaSoft InterSolv 
0989 767656 0392 217670 0727 812812 
Single User £149 £490 £400 
10 User Licence 2 £1764 £3600 


Figure 1 - Comparison of version control systems 


16 EXE Magazine, Vol 7, Issue 5, October 1992 


Hence the (slightly OTT) reference to Or- 
well’s ‘1984’ in the title of this article. 


The Ins and Outs 


All VC tools operate in more-or-less the 
same way, possibly having inherited their 
basic features from the standard UNIX 
utility SCCS (Source Code Control System). 
Anew source file must first be ‘put’ into the 
VC system: the file is archived and is stored 
as a ‘revision’ (actually revision 1.0), When 
a programmer wishes to modify the file he 
‘retrieves’ it, makes appropriate changes; 
and puts it back when he has finished. This 
time the VC system will check if there are 
any differences between the revision stored 
in the archive (revision 1.0) and the current 
file being submitted by Put. If there are, the 
VC system will only store the differences (as 
Revision 1.1), Also the programmer is 
prompted to give a brief description of the 
changes he has made. And so the Retrieve- 
Edit-Put cycle will continue under version 
control. Each iteration of this cycle results 
in the revision number being incremented. 


During the development process there may 
be times when a development path must be 
split - for instance to incorporate platform- 
specific features into a project. This is 
where a branch is used. Branching enables 
a new line of development to continue in 
parallel with the original development line. 


VC comes into its own when a team of pro- 
grammers is working on a project. Multi-user 
VC systems use file locking - analogous to 
record-locking on a database - to ensure that 
only one user can edit a source file at any one 
time. Other programmers on the team are 
given Read-Only access to the file until it is 
Put back. This implies that there are two 
flavours of Retrieve - one provides Read- 
Write access to the file; the other, Read-Only 
access, When a file is retrieved with Read- 
Write access, a flag is raised in the VC system 
preventing anyone else from retrieving that 
file with Read-Write access, 


HYPERDESK 
KNOWS NO 
BOUNDS 


DISTRIBUTED OBJECT MANAGEMENT SYSTEM 


Hardware & Software 

Independent - applications are 

able to run across multiple hardware > 
platforms and software 

environments. 


another without describing a fulfillment 


method. 

< Unique Dynamic Design - users are 
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applications or incompatibilities 


The Only Complete DOMS - has between hardware and software. The 
the versatility to define, build, dynamic operation makes it easy to 
modify, integrate and deploy the > < enhance systems as the users’ 
distributed object oriented mi needs change. 

applications needed by large First Industry-Standard DOMS - 
organisations. complies with the established 


Object Request Broker (ORB) - 
a clearly defined two-way 
communication mechanism allowing 


Common Object Request Broker 
@ Atchitecture (CORBA) standard of 
the universally supported Object 


objects to request services of one Management Group (OMG). 
HyperDesk from HyperDesk Corp, is simply the on building applications and realise the true 
best - a fully integrated set of advanced advantages of open distributed computing - 
software tools and services for building and simplified access to all kinds of information, 
integrating open distributed applications. It wherever it resides in a computing environment. 


overcomes even those seemingly impossible 


situations experienced by developers in complex fp beLoesxiKniowsiNol Pounds, aa 
heterogeneous computing environments. At Protek, we understand and fully support ~~ 
HyperDesk enables developers to manage the the universality of objects and their role /~ Please send 
variety of application programming interfaces, in greater software productivity. yf j ne Lpber Desk 
information sources, network protocols and Clip the coupon or call us now Mormon et 
operating systems. It allows them to concentrate for full details. ee 
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PROTE / 
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Multi-user systems run off a network so 
security is also an issue. To prevent un- 
authorised access, the VC system keeps a 
log of which users can see which source 
files and whether they have Read-Write or 
Read-Only access. 


VC systems come with a suite of tools to 
complement the basic version control func- 
tionality. An essential component of a VC 
system is the Report Generator, which gives 
a complete history of all changes made to a 
given source file, the reason for the modifica- 
tions and who made the changes. Another 
utility common to all VC systems is the DIFF 
tool, which lists the differences between two 
revisions of a source file. This is most useful 
for tracking down where a bug was intro- 
duced or for showing a programmer the 
modifications he made to the most recent 
revision when putting back a file. 


Associated with version control is a tech- 
nique called Configuration Management. 
This is a grand name fora tool which essen- 
tially works like a glorified MAKE utility. 
Just one version of a software product may 
consist of several files, each with differing 
revision numbers. Configuration manage- 
ment tools are able to retrieve all relevant 
files from the VC system and compile/link 
them to produce an application. The power 
of these tools lies in the fact that an appli- 
cation can be built from any revision of the 
source files - ie they are not dependent on 
the current revision of each file. 


The Issues 


The problem with VC software is not with 
the difficulty in using the tool - after all most 
users are happy to make do with only two 
commands (ie the put/retrieve pair), but 
with the organisation of a project and its 
associated source files. In a single us: 
tem, the question is that of the alrecraty 
structure. Where should the source files be 
placed? Should separate functional blocks 
be kept in different directories? Should ob- 
ject files be stored separately to source 
code? Such questions relate to the size of a 
project - if it is large, a more structured 
directory tree is preferred. However com- 
plicated directory trees tend to hamper na- 
vigation in a small project. 


More important are the questions concerned 
with actual working practices, such as when 
and how often should workfiles be put into 
the VC system? In a team consisting of several 
programmers, this is the responsibility of the 
project leader. Along with the task of dividing 
the project amongst his programmers, the 
project leader will additionally have to con- 
sider issues relating to security and maintain- 
ing the integrity of the software. For instance, 
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a typical scenario may consist of several 
programmers, each working in parallel on 
a different software component of an appli- 
cation. The question is integration - how 
does one decide whether to retrieve the 
most recent revision of the source files, or 
opt for a more ‘stable’ revision? 


The remainder of this article comprises < 
review of three version control systems, For 
comparison, I have compiled a summary 
list of their main features in Figure 1 


9K 


9K is a single-user VC system from Forté 
Software Tools for DOS which provides 
in-built support for the .DBF xBASE file 
format. Forté Software is also planning a 
multi-user version of 9K. 9K is distributed 
on one 720 KB disk and the installation 
program creates a single directory called 
9K, in which it places all the program files. 
9K requires a whisper under 300 KB of disk 
space, In addition to a single executable, 
Forté has also provided a .PIF file for run- 
ning 9K under Windows. All that’s required 
to get going is to add the 9K directory to 
your PATH and key in ‘9K’, 


9K is based around a user-friendly text- 
based front-end with drop-down menus. 
Unlike many VC systems, which work with 
individual source files, it maintains a soft- 
ware inventory called a project, consisting 
of one or more source files. Before putting 
anything under version control, it is nec 
ary to set up such a project. This is quite 
straightforward using the New Project clia- 
log box. 9K asks you to provide a project 
name, a directory where the source files are 
kept and a directory to store archives, Once 
a project has been created, it draws a pro- 
ject window, showing the directory struc- 
ture of a project, and a file list window. 
Switching between the two windows is 


achieved with <TAB>, the cursor keys are 


CAS napshot| 


Retrieye Version 


vcs 


used to navigate, and <ENTER> 
a file. Highlighted files can be 
removed from the project. They 
be examined using the built-in fi 


highlights 
added or 
may also 
le viewer. 


Changes to a project are recorded in what 
Forté calls snapshots. Like their photo- 
graphic counterparts, these snapshots give a 
complete ‘picture’ of a project ata given time 
and date. When a snapshot is taken, 9K 
igures out whether any of the project files 
have been altered since the most recent snap- 
shot and, if this is the case, the user is 
prompted to provide a snapshot comment. 
9K also provides the ability to associate a 
given snapshot with a version number. 


Jnlike the other VC systems in this article, 
9K doesn’t use the familiar retrieve-edit-put 
cycle. The retrieve stage is missing, and put 
has been replaced with a ‘Take Snapshot 
command. Since 9K is a single-user system, 
file-locking is pointless. The user has Read- 
Write access to allsource files in the project 
and so he can edit any file to his heart’s 
content. When he finally decides that it’s 
time to place the files under version control, 
all that’s required is to take a snapshot of 
the project. 9K does the rest. Forté Software 
has suggested that the easiest way to run 9K 
is from a DOS shell within your favourite 
editor. Snapshots should be taken at the 
end of each working day, comparable to 
the way we’re supposed to back-up our 
hard disks every day, allowing the user to 
backtrack to any stage in the project. 


a 
g 


The Report generator is quite rigid since there 
is no way to customise the format of informa- 
tion it provides. However, like the rest of the 
package, it is interactive and has a number of 
built-in report types, These enable the user to 
check the history of snapshots/version num- 
ders, look at the state of the project for a 
specified snapshot/version or compare two 
files from different snapshots/versions. The 
file comparison feature is particularly good, 


Report Tue Sep 68 14:25:52 1992 


«source \READHGB « € as of Tue Aug 25 10:16:5@ 1992: 


flinclude “palette.h” 


7* Function ReadRGB */ 


7% to vead current RGB settings for text screen. 


void ReadRGB (colourtriplet PalBuffL1) 
£ 


union REGS Regs; 
struct SREGS Segs: 


[Change 


ae 4) a= Change 


#7 


Jee L ine 


.\source\READRGB.C as of Tue Sep @8 14:25:38 1992. 


ttinclude aint th> 
flinclude “palette.h” 


7 Function ReadRGB */ 


7* to read current RGB settings for text screen. 


void ReadRGB (unsigned char *PalBuff > 
t 


union REGS Regs; 
struct SREGS Segs: 


[Change 


4]—______- > 
Help | ireu ENext [eSuap [conn Hist [eéoon JEL No. Je) | 
Figure 2 - Split-screen file comparison tool in 9K 
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LLine 


Why do the 
Call it a dongle? 


H; wasn’t famous, He 
didn’t drive a fancy car, 
but dressed in his favorite 
Comdex T-shirt and faded 
blue jeans, he set out to 
change the course of the 
computer software industry. 
Quite a task for a lonely 
soltware developer. 

Sitting in front of his 


, computer, 
Ye drinking 

: pots of 
Le 


‘ coffee 
hos = and 

: smoking 

‘cartons of 
cigarettes, 

“ he'd write pages 


of code, 

It took time. Years in fact, 
But he did it. He wrote the 
most powerful computer 
program in the world. Now 
came the hard part. Selling it. 


The Most Powerful 

Program in the World 
Determined to make those 
long years pay off, he called 
on every distributor, VAR and 
dealer in the world. He drove 
from Beantown to San Diego, 
Flew from Dublin to Borneo. 
Everyone loved the program. 

So he sold a few. Only 
a lew. 

Back in Boston he 
waited. Alter a long year 


with only 13 orders he set 
out to see what happened. 
As he drove across the 
_ country and 
flew around 
the world he 
discovered everyone 
knew about his program. 
Everyone had it too. 

The Global Marketplace 
From Paris to Prague, his 
program was everywhere in 
Europe. When he got off the 
plane in Hong Kong he found 
lis program stacked to the 
ceiling in every computer 
store. Amazed in disbelief, he 
bought a hundred cartons 
of cigarettes and a hundred 
pounds of Indonesian 
coffee and flew back 
0 Boston. 

Beaten, battered 
and bruised he went 
back to the drawing 
board. This time he 
would really 
change the face of 
he software industry. 
He would develop a device 
hat would prevent 
unauthorized distribution 
of software programs. 


Call It What You Like 

He developed a hardware 

ey. His peers applauded his 
efforts. Finally, a solid solution 
‘or revenue protection. 


But he didn’t know 
what to call it. He thought 
of naming it after an exotic 
place he visited in his travels. 
Madagascar was a bit too 
long, though. 

“Name it after you, 
Don!” urged his peers, 
So he did, Soon 
everyone was calling 
the key a dongle, © 
alter Don Gall— 
the lonely soltware 
developer who did 
what he had to do, 


You've Come 
A Long Way, Baby 
Today, dongles are different. 
Fact is, they've come a long 
way. Leading the 
industry with 
Bie security salto 
*— > Rainbow Technologies 
has changed the face of 
hardware keys, They work 
with multiple applications, 
are programmable and 
network versions control 
concurrent usage, And 
they’re always transparent 
to the end-user, 
Sentinel Family 
from Rainbow 
Truth is, more and more 
developers are using keys. 
And the Sentinel Family is 
the most widely used in the 
world. In fact, over 6,000 


developers use Sentinel from 
Rainbow. Why? They are 
simply the most effective, 
reliable and easy to implement 
keys on the market, 

Learn more about securing 


your software 
and how keys 
provide developers 
with extra value, 
Call for a free copy 
ol “The Sentinel 
Guide to Securing 
Software.” And sce 
just how easy it is to 


install a hardware 
key into your | 
application in just Q S 
minutes, Try it Ee 
with our low cost 
Sentinel a 
Evaluation Kit, = € 
Order one for 

your DOS, OS/2, Windows, 
Macintosh or UNIX based 
application, 

And remember, when 
you need a dongle, you need 
Sentinel —the only dongle 
Don Gall would use. 

Call us now for 


your free 
evaluation kit 


Sea inel 


Securing the future of software 


Some call it a dongle. Those who know, call it Sentinel. 
@RAINBO 


TECHNOLOGIES 


Rainbow Technologies Ltd, 4 The Forum, Hanworth Lane, Chertsey, Surrey KT16 9JX 
Tel: 0932 570066 Fax: 0932 570743 
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THE SOFTWARE CONSTRUCTION COMPANY 
The Visual Basic Specialist 


EE CALL FOR Visual Basic CATALOGUE EE 


Visual Basic, the best selling programming tool for 
Windows, is now available for DOS. Visual Basic for 
DOS, the replacement for Quick Basic 4.5, is the new 
way to develop powertul, attractive applications for the 
DOS operating system. Use an event-oriented 
programming model and rich user-interface tools, to 
create applications in record-breaking time. The 
Professional Edition adds even more power witha 
highly-optimising compiler, integrated database ISAM, 
acharting and presentation graphics toolkit, a custom 
control development kit, and the same overlay 
technology as Microsoft C/C++ 7.0. 


VBAssist 


VBAssist from Sheridan works with Visual Basic for 
Windows to make you the most productive Windows 
application developer you can be, by letting you do 
things you do most often with a single mouse click. 
Provides functions for aligning controls, sizing and 
stacking, array management, viewing and modifying 
the tab order of controls, Tools to view and change 
property values of a control, code librarian to save and 


retrieve source code by name, 

generate dialog (.DLG) scripts and 

much much more. An essential tool 

for the serious VB developer. 

Agility/VB 


Agility/VB is a database engine designed for Visual 
Basic. Agility/VB's set-oriented function calls make it 
fast and easy to develop simple-to-use interfaces with 
a minimum amount of effort. Built-in query-by- 
examples (QBE) searching facilities make ad-hoc user 
queries a snap. The View Editor enables the 
programmer to use a graphical tool to define complex 
file relationships and indexing criteria for. dBASE 
databases, indexes and memo 


fields are fully supported as well as 
a native file format which supports 
variable length records and fields. 


MicroHelp VBTools 


VBTools customises Visual Basic for Windows' 
Toolbox to create a programming environment tailored 
to the needs of the programmer. More than 30 custom 
controls install themselves in the Toolbox and you 
program them just like regular controls. Includes: 
sizzling graphics special effects that transform one 
bitmap to another; 'how to' info on using popular 
Windows API calls, 3-D effects and routines to do 


mouse scrollbars. GD 


MicroHelp Muscle 


MicroHelp Muscle/VB adds over 400 high powered 
routines, written in Assembler for high speed, smaller 
executable files and more functional programs. 
Routines include display, string, array, mouse, 
memory, file and device, disk and directory, system, bit 
manipulation, error handling, Window services, date 


and time and much more. 


Your code investment is protected - today and 
tomorrow - because Visual Basic for DOS runs all 
code written with Quick Basic and Basic PDS 7.1, and 
is highly compatible with Visual Basic for Windows. 
Visual Basic for DOS Standard Edition replaces Quick 
Basic 4.5. Visual Basic for DOS Professional Edition 
replaces Basic PDS 7.1 Both products are dual media. 
How do | upgrade ? 

The cost to upgrade to Visual Basic for DOS standard: 
£79 + VAT from Quick Basic. The cost to upgrade to 
Visual Basic for DOS Professional Edition: £149 + 
VAT from Quick Basic, Basic PDS and owners of 


3-D/Widgets 


Pump up the controls with 3-D/Widgits. You may have 
already seen some of these Widgets in the Microsoft 
Visual Basic Toolkit. With 3-D/Widgets you can create 
high impact Windows applications by including ‘state 
of the art’ 3-D look. Some of the controls included are: 
listboxes supporting multi-column, multi select, 
horizontal scrolling, Combo boxes which support hard 
and/or soft tabs plus pictures for each list item, 
command buttons with captions 

and/or pictures plus variable 

forecolours and bevel width, 

Ribbon buttons like those in many 

popular Windows applications. 


Visual Basic Toolkit 


The Microsoft Visual Basic Professional Toolkit is a 
collection of add-on tools that extends the capabilities 
of Visual Basic. Most of the tools are custom controls 
that can be installed on the Visual Basic Toolbar, so 
operating as if they were part of Visual Basic itself. 
These additional controls help you quickly create full- 
featured applications that include charting, 3-D 
interface components, MDI child windows, grids, 


Q+E Database/VB is a complete set of database 
custom controls that let you quickly create database 
applications without writing code. For example, scroll 
bars that automatically scroll through your database 
records are just a point and click away. With full record 
locking so you can put your finished applications on 
the network - royalty free. Q+E/Vb has all the functions 
you'll ever need and it's full dBASE compatible. You 


Software Paths! Validation Control provides automatic 
validation of data entered by the users of your 
application for data types such as text (convert to 
upper/lower case, password input, ignore blanks), data 
(range validation, configure decimal separator), times 
(12 or 24 hour, range validation) and dates (configure 
DMY, MDY or YMD) or currency values. The validation 
control is a completely integrated Custom Control for 
Visual Basic that can be 

incorporated into your application 

as easily as any standard control. 


object linking and embedding, pen 
computing support, animated 
buttons and more. 


can even store pictures and bitmap 
filenames directly in the Q+E/VB 
database. 


Visual Basic for Windows. Proof of ownership is 
required, either return your original set up disk, front 
page of your manual or copy of sales invoice. Visual 
Basic for DOS will be available during September, the 
product is expected to be in large demand so early 
placement of orders is recommended. Call the Visual 
Basic order line now on 0763 244114, 


Visual Basic for DOS Standard r £89) 
GD Basic for DOS Professional 


CodeBasic 


CodeBasic from Sequitter Software is the leading Data 
File Handler for Visual Basic for Windows. CodeBasic 
provides routines to access dBASE III/IV, Clipper and 
FoxPro file formats with support for Clipper and Foxpro 
2.0 index files. Supports single or multi user 
applications with full file and record locking. Distribute 
your applications royalty free. We recommend this 
product very highly, our development team have been 


using Sequitter products for some 11 


time. 
PDQComm for Windows 


PDQComm for Windows is a comprehensive library of 
subroutines and functions for adding communications 
to programs written in Visual Basic for Windows. It 
contains both high and low level routines for controlling 
the communications ports, sending and receiving data 
(XModem, YModem, XModem-1K & ASCII) and 
popular terminal protocols (ANSI, VT52 & VT100). All 
of the Assembler, C and Visual Basic source code is 


included. PDOQComm for Windows 

comes with a comprehensive 

owner's manual, demo programs 

including a terminal program... 

QuickPak Prof. for Windows 


QuickPak Professional for Windows is the most 
complete collection of subroutines, functions and 
custom controls for Visual Basic for Windows ever 
produced. It includes more than 400 services that help 
you improve the quality of your programs and 
complete them faster. All the low-level routines are 
written in Assembler for the fastest possible speed and 
smallest possible code size. Routines include: date 


and time, keyboard, financial and Gp 


scientific, strings, DOS services, 
array processing and more. Demo 
programs included. 

Visual Basic Shareware 
The Visual Basic Utility Library by EMS is probable the 
best £40 you could ever spend. A collection of over 
170 files specifically for Visual Basic for Windows, this 
new library contains a wide variety of applications and 
utilities, most with source code. It also includes a 
Windows based directory of all files in this library and 
many commercial Visual Basic utilities and add-ons 
including, communications, business, desktop, disk, 


finance, language extensions, r £40 


programming utilities, printer 
utilities and many more. 


4-5 The Quadrant, Newark Close, Royston, Hertfordshire SG8 5HL Tel.: 0763 244114 Fax: 0763 244025 
All prices include delivery but exclude VAT. 
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using a multicoloured split screen to high- 
light differences between two source files 
(see Figure 2). 


As I stated earlier, a nice feature of 9K is its 
ability to store xBASE files. Whenever a 
.DBF file is added to the project, 9K gives 
the user the choice of either storing just the 
structure of the table or saving the data as 
well, When the table and its data are put 
under version control, 9K tracks changes 
made to both the database structure and 
database records - adding a transaction log- 
like facility to dBASE. However it doesn’t 
keep track of index files - but these aren’t 
relevant to VC since they only affect the 
speed in which data can be accessed. 


Documentation takes the form of an 88 
page spiral-bound User's Guide with exam- 
ples to illustrate how to use 9K. Forté Soft- 
ware also includes a context-sensitive Help 
system with the package. 


I'll end with brief mention of the command- 
line version of 9K: it does exist, but it suffers 
from complicated command-line flags and 
simply invokes the front-end to perform the 
required operation. I would guess that most 
users would stick with the front-end - since 
it can be run from within a text editor. 


SMS 


Software Management System (SMS) from 
Intasoft is a multi-user VC system available 
for several platforms including DOS, OS/2 
and UNIX. The review software was a 
single-user licence of SMS for MS-DOS. The 
rather primitive installation from three 720 
KB diskettes uses a batch file to copy the 
executables onto the hard disk. This must 
be modified in order to change destination 
drives or directories. SMS consists of 43 files 
and needs just over 1.5 MB of disk space. 


Figure 3 - Lifecycle of SMS’s 
Modification Request 


Like 9K, SMS offers a text-based front-end 
which encapsulates the complete VC sys- 
tem. However the SMS front-end is not as 
‘pretty’ as 9K’s and it lacks drop-down 
menus. The user is subjected to numbered 
menu items, although these can be selected 
with a mouse. In SMS, a project is synony- 
mous with a directory. Unlike 9K, I could 
find no particular significance of an SMS 
project (ie for grouping all project files 
together), apart from the fact that the pro- 
ject directory always contained a subdirec- 
tory called SMS which held the archives. 


One of the problems I encountered with the 
system is that certain important functions, 
such as selecting files from the file list, are 
not available from the menu and use non- 
standard keys. For instance to display the 
file list you have to press the <F2> key 
(<F6> gives you the archives list), IntaSoft 
explained that the interface was designed 
this way to be consistent across all plat- 
forms that SMS could run on (even VAXes). 


Unlike 9K, there is no built-in file viewer. 
However SMS can be configured to call 
your own editor when the Edit File menu 
item is clicked. Files are retrieved from the 
archive with the TAKEOUT command and 
put back using PUTAWAY. As SMS is a true 
multi-user system, it provides a full file- 
locking facility. In order to retrieve a given 
ile, it is necessary to select it from the 
archive file list; putting the file back in- 
volves selecting it from the source file list. 
To simplify this process somewhat, Intasoft 
has included the facility to TAKEOUT and 
PUTAWAY files automatically each time the 
user selects a file to edit. SMS supports 
several VC directives (such as $LOG$) 
which can be inserted as comments into 
source files to tell SMS to write certain in- 
formation to the file every time it is PUTA- 
WAY. This information includes the date, 


Ve 


reason for modification and the name of the 
user who made the change. 


Two types of reporting are provided by 
SMS. The first is ‘smsinfo’ which give infor- 
mation about the archive in a fixed format. 
Output is written to a text-file. The user can 
specify a particular revision to look at or 
examine revisions either before or after a 
given cut-off time or date. The other repor- 
ting function is ‘smsrep’ which provides 
similar output. However it enables the out- 
put to be customised using a configuration 
file. This lets the user select which informa- 
tion should be included in the report and 
the order in which the information is 
presented. For instance, a project manager 
may wish to produce a complete report of 
the entire project for himself, and create a 
summary for his superiors. A file compati- 
son utility is also provided, although, unlike 
OK’s, it isn’t interactive, 


IntaSoft has included the Autobuild tool to 
simplify configuration management. This 
uses a template called BUILD. TPL to create 
a ‘Build’ file for compiling/linking an appli- 
cation stored in SMS, Autobuild can’t deter- 
mine dependencies on include files 
automatically, although it can create the 
simple object filename : source 
filename relationship, The Build file it- 
self can be edited to add user-supplied 
compilers/linkers/librarians ete. When files 
are added or deleted from the project, Auto- 
build re-creates the Build file. 


Another feature of SMS is the Modification 
Request (MR) facility. A MR provides a for- 
mal way of reporting and fixing bugs. When 
a MR is created, it is associated with a given 
source file and is assigned to a specified 
user, A MR has a life cycle, starting with 
submitted and ending with released (See 
Figure 3), When a user decides to work on 


| SUBMITTED i he ae 
E Be on. REJECTED 


ACCEPTED 


FIXING 


TESTING 


| COMPLETED 


RELEASED 


Figure 4 - Promotion Model for a typical PVCS project 
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the MR, he changes its status and alters the 
given source file. To keep the MR syn- 
chronised with the revision of the source 
ile, it is updated each time the file is re- 
trieved or put back into SMS. The MR is 
actually stored as a text file, so the truly 
high-tech project managers among you can 
send the MR electronically to an unsuspect- 
ing member of your programming team. 


Documentation in SMS is extremely good. 
There’s a 26 page Tutorial and a 220 page 
User's Guide. The User's Guide is arranged 
alphabetically as a command reference 
with many examples. The front-end has a 
built-in context-sensitive Help system 
which is fairly easy to use. 


SMS also comes with a command-line ver- 
sion of the package which is entirely inde- 
pendent of the front-end. One of the 
problems with using the command-line 
tools is that the PUTAWAY command must 
be given a special flag the first time a new 
file is placed under version control. This 
could cause problems when creating a 
batch-file driven VC system with SMS. 


PVCS 


Probably the most widely used PC version 
control package to date is Intersolv’s PVCS 
Version Manager (VM). This is a multi-user 
VC system for DOS, OS/2 and UNIX. The 
latest release is V5.0. This is distributed on 
twelve 720 KB diskettes and a full installa- 
tion consumes about 8 MB of disk space. 
The review software was PVCS VM V5.0 for 
MS-DOS (single-user licence). The package 
includes both Real and Extended mode ver- 
sions of the software, 


Getting started with VM is an order of mag- 
nitude more complicated than either 9K or 
SMS. The first step involves creating a con- 
figuration file called VCS.CFG. A copy of 
this file is needed in each directory in which 
project source files are placed. It contains 
information such as the name of the user, 
the directory where the source files are kept 
and the name of the directory to place the 
archived files. PVCS includes example con- 
figurations for single and multi-user setups 
which can be modified to suite your own 
projects. 


Of the three VC systems in this article, PVCS 
offers the least sophisticated front-end. In fact, 
the review software didn’t include the front- 
end at all - it is due to be shipped later this 
month. Under the advice of Intersoly, I in- 
stalled the V4.0 front-end. Apart from being 
Windows-hosted, the PVCSWIN front-end re- 
ally has nothing to offer. On starting 
PVCSWIN, the user is confronted with a 
simple dialog box with radio buttons for se- 
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lecting the following commands: Fetch- 
ing/Retrieving files from the archive, Re- 
port Generating and comparing files. When 
one of these is selected, the appropriate 
dialog box pops-up and the user has to type 
in all the information required (ie file- 


UMMM 


The PVCS front 
end is completely 
inappropriate, 
but it does 
integrate with 
various IDEs 


names). No use is made of the more soph- 
isticated Windows controls such as file list 
boxes. As it stands PVCSWIN is best 
avoided, 

However this is not the case with the com- 
mand-line tools. Once VCS.CFG has been set 
up, all that’s required to use PV he PUT 
and GET pair of commands. Like SMS, it 
supports full file-locking and a number of VC 
directives that may be placed in source files. 


PVCS provides a number of report-gener- 
ating tools. The first is the JOURNAL 
which outputs an audit trail of all PVCS 
commands that have been used to modify 
the archive (ie PUT and GET commands), 
The information is presented with the 
date and time that the command was in- 
voked, together with the user who per- 
formed the operation. The VJOURNAL 
command is used to view the journal. A 
project manager can check the current 
state of a project using the VLOG com- 
mand. This details archive attributes, 
such as the name of the user who created 
the archive, a description of the workfile 
and the revision numbers of all currently 
locked revisions. It also provides a revision 
summary which shows a log of all revisions 
made to an archive. This log includes the 
date/time a revision was made, the number 
of lines added/deleted/moved and a de- 
scription of the modification. The format of 
the report can be specified using a tem- 
plate .RPT file. There is also a file com- 
parison program for checking the 
differences between two revisions of a 
file without having to take the files out of 
the archive. 


Work ona large software project will tend 
to consist of several distinct phases (ie De- 


VCS 


velopment, Testing and Quality Assur- 
ance), In PVCS, source files can be grouped 
together and be moved, as a single unit, 
through these stages in the project lifecyle. 
When a group is ‘promoted’ from develop- 
mentto the next level (eg Testing or Quality 
Assurance), PVCS locks the groups, pre- 
venting any project source code from being 
modified. The only way one can change 
source code is to use the VPROMOTE com- 
mand to downgrade the project back to 
Development (see Figure 4). This tech- 
nique enables the project manager to re- 
duce the risk of introducing bugs into 
software at a late stage in the lifecycle. 


PVCS comes complete with comprehensive 
documentation, There is an Installation 
Guide and an 85 page User Guide called 
Getting Started which runs through a 
simple tutorial to demonstrate the main fea- 
tures of PVCS and to examine the principles 
behind version control. Source code re- 
quired by the tutorial can be found in the 
PVCS\VMTUT directory. A 437 page Ref- 
erence manual provides an alphabetical 
list of all PVCS commands. Finally there's 
a Quick Reference and PVCS Extensions 
which shows how to link PVCS into sev- 
eral IDE's. 


Although the PVCS front-end is completely 
inappropriate as itstands, PVCS does offer the 
ability to integrate into the IDEs of IBM 
AD/Cycle WSP/2, Micro Focus Cobol Work- 
bench, Microsoft PWB and HP Softbench. 


Conclusion 


Although version control on a single-user 
project is perhaps a tad over-the-top, 9K 
seems to offer the best value-for-money in this 
league. An attractive price, fully integrated 
front-end and ease-of-use makes it a good 
buy. Furthermore, for those of you who wish 
to ‘learn the ropes’ on version control, 9) 
seems to be an ideal place to start. 


Ina multi-user project, both SMS and PVCS 
provide similar features. If you prefer to use 
front-ends SMS has the better one, although 
PVCS offers powerful integration with 
third-party IDEs. For command-line buffs, 
PVCS is easier to use, once it has been set 
up. If your looking for the most version 
control for your money, SMS seems to have 
the edge. Unlike PVCS, the price includes a 
complete Configuration Management tool 
(PVCS Configuration builder costs £200). 
However readers should note that PVCS is 
the market leader, implying that it is a stable 
product which is likely to be available sev- 
eral years from now. 
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The need for Low Cost CASE 


Received wisdom states that CASE is only worth considering if you operate a huge 
DP department. Patrick McParland argues that it bas wider application. 


Low cost CASE is the use of CASE (Com- 
puter Aided Software Engineering) tools by 
small to medium-sized companies on small 
to medium sized applications. Vendor's mar- 
keting material often contains glowing praise 
which independent software developers 
shower on a CASE tool, frequently reflect- 
ing the successful introduction of CASE into 
a large multinational corporation. As a con- 
sultant, based in Northern Ireland but work- 
ing throughout the UK, I have often 
recommended the use of CASE tools. How- 
ever, when dealing with smaller companies 
such advice can be impractical due to the cost 
and verbose nature of many CASE tools, 


For CASE to become successful, it must be 
made palatable to companies developing 
small applications. The benefits of CASE 
must outweigh its weaknesses regardless of 
the scale of the application or company. 


What are the benefits? 


By far the major benefit in using CASE tools 
is the reduction of resources required to main- 


tain applications which developers build 
using the CASE tool. Many studies claim 
that maintenance makes up between 60% 
and 80% of a project’s costs (see Figure 1). 
Some CASE tools provide reverse engineer- 


WML 
One of the major 
weaknesses of 
the use of many 
CASE tools is that 
they can reduce 
productivity 


WUC 


ing tools to assist the maintenance of old 
applications. By using a CASE tool, devel- 
opers can ease their current and future 
maintenance load. 


CASE tools which provide automatic code 
generation facilities, aid maintenance by 
keeping a dynamic relationship between 
the application's specification and its code. 
If a developer changes the specification 
and regenerates the application using the 
CASE tool, then the application’s code is up 
to date with respect to the specification. 
Maintaining an application is easier when 
its specification is available. CASE tools also 
aid maintenance by encouraging devel- 
opers to work at the design level rather than 
the code level. They also provide cross 
reference and impact analysis tools (which 
highlight the objects in an application's de- 
velopment which are affected by a change). 


The other major benefit of using CASE tools 
is their support for one or more software 
development methods (eg Information En- 
gineering or SSADM). In fact, to use a CA! 
tool without a method is equivalent to driv- 
ing a car without previously having taken 
driving lessons or referring to the highway 
code, By supporting such a method, a CASE 
tool encourages software developers to de- 


Programming 7% 


Specification 11% 


Testing 15% 


Testing 24% 


Maintenance 67% 


Integration eta ne 


Analysis 13% 


Design 17% 


Programming 26% 


Figure 1 - Total Project Costs 
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Figure 2 - Development Effort by 


Software Life Cycle Phase 


Maximise Productivity, 
Minimise Mistakes 


To produce and maintain reliable software requires a comprehensive configuration 
management strategy. This strategy must support work group development on LANs, 
with distribution across multiple servers, wide area networks, and host systems. 


The PVCS Series for Configuration Management 


The PVCS Series for Distributed Environments 


Personal Workgroup Enterprise Enterprise 
Workstation LAN LAN Workstation 


Today’s development environment 
requires integrated development effort 
across platforms and operating systems. 


Support for UNIX and heterogeneous workstation and LAN environments. 


To optimise the use of resources, it is imperative for the configuration management system to 
distribute the required functionality to appropriate platforms. This means the manager must operate 
seamlessly across PC-DOS, OS/2, LANs and a variety of UNIX systems. This protects your 
organisation’s investment in existing technology and assures compatibility for future growth. 
Special prices for single users: 

DOS or OS/2 or AIX : PVCS £299 — Configuration Builder £135 PVCS Professional Editor £159 
DOS and OS/2 : PVCS £399 Configuration Builder £175 = PVCS Professional Editor £199 


Tel (+44) 071 6255255 FReadmar Systems _ Sales and support tor 


Fax (+44) 071 624 9404 sy Development Software 


239, KILBURN PARK ROAD, LONDON NW6 5LG 
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Data validation the easy way 


True Visual Programming, just 
point and click to define the 


behaviour and look of your 
input fields 


Save development time with 
ready-to-use intelligent fields 


No royalties 


RosBoHEL-r is an automatic authoring tool 
that makes the process of creating a 
Windows Help System just a matter of 
pointing and clicking. 


Guides the user through all the necessary 
steps — the user just fills in the actual help 
text when prompted. 


A ROoBoHELP features a customisable Visual 
Tool Palette. 


A Generates RTF, HPu & H files and compiles 
the Help file. 


It is no longer necessary to be a 
programmer to create a Windows Help 
System. 


A ROBOHELP takes the hassle out of making 


Microsoft Windows Hypertext Help systems. 


You will be productive from the first minute. 


_SuvMisoOS ANS 3N12 


For more information contact the UK distributor 


ExpoTech (UK), ExpoTech House, Western Road, Hove, Sussex BN3 1AF 
Tel: (0273) 749222 Fax: (0273) 746446 
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velop their applications in a more struc- 
tured way. If all developers apply the same 
method, then new developers can be incor- 
porated into a project team more easily. 
Also controlling and managing the devel- 
opment of large applications is simpler be- 
cause all developers are using the same 
development techniques and notation. 


A further benefit of using a CASE tool is its 
support for new technologies. The CASE 
user relies on the CASE vendor to provide 
support for the development of applica- 
tions which use the latest GUIs (Graphica 
User Interfaces) or client/server architec- 
ture. The technological risk of choosing 
which window manager or client/server 
architecture to support is shared equally by 
all companies using a particular CASE too) 
and its vendor, In general, most CASE tools 
will seek to support the most widely used 
window managers and client/server archi- 
tectures. They do so in such a way that 
developers will not have to take account o! 
which window manager or client/ server 
architecture they wish to use until they want 
to generate their application. The CASE tool’s 
code generator can then be configured ac- 
cordingly. Porting applications between 
different code generator configurations is 
not usually a major problem. 


CASE weaknesses 


Despite the vendor hype to the contrary, 
one of the major weaknesses in using of 
many CASE tools is that they can reduce 
productivity. This is particularly true during 
early usage of a CASE tool. Developers can 
take many months to become familiar with 
the development method the CASE tool 
supports and the CASE tool's facilities. How- 
ever, even after the developer overcomes 


differ substantially from what it was prior to 
the introduction of the CASE tool. This is 
because a CASE tool encourages developers 
to spend more time analysing and desig- 
ning an application and less time on pro- 
gramming. However, as Figure 2 
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demonstrates, programming takes on aver- 
age 26% of resources in a typical develop- 
ment environment. Savings in the 
programming phase of the software life 
cycle, although important, may be offset by 
extra effort during analysis and design 
(which take 30% of resources). 


However, perhaps the most serious prob- 
lem with many current CASE tools is their 
cost. Prices range from £3,000, for a single 
PC copy, to over &300,000, for a multi-user 
licence on a large mainframe site. Further 
costs are also necessary for training and 
possibly consultancy. Some authors claim 
that for every &1 spent on the acquisition of 
a CASE tool a further &2 is necessary for 


CASE 


training and consultancy. Certainly, if you 
buy a CASE tool then you should budget for 
a large amount of training. 


Justifying this expense to a prudent finan- 
cial director can be a major problem. This 
problem is compounded when you con- 
sider that the company will probably not 
receive a return on its investment during the 
current financial year. In particular, savings 
on the development of a new application, 
using a CASE tool will only be realised 
when the application is being maintained; 
long after its initial development is com- 
plete. 


A further weakness of some CASE tools is 
that the methods they support are too ver- 
bose. The development of even the sim- 
plest application becomes a major task. 
This is particularly annoying when a de- 
veloper could build the same application 
quicker, while still keeping the application 
maintainable, using a 4GL. Thus for small 
or even medium sized applications the use 
a CASE tool, with all its analysis and 
design techniques, can be a huge overkill. 


o 


CASE for small companies 


The above weaknesses with CASE tools 
virtually kill off the possibility of a small 
company (or a small DP department) 
adopting a CASE tool as its main develop- 
ment tool (especially in the current econ- 
omic climate), Even a medium sized 
company may not be able to afford the 
expense. Also, if the major advantage of 
CASE tools is in easier maintenance, then 
small to medium sized companies with 
fewer, and perhaps smaller, applications to 
maintain may not have major maintenance 
problems which require a CASE tool as part 
of the solution, 


this learning curve, productivity may not 
Product Areas Supported 
CASE:W CASE:PM Design, Prototyping, Code Generation 
Easy CASE Analysis, Design 
POSE Analysis, Design, Code Generation, 
Reverse Engineering 

Prototyper Analysis, Design, Code Generation 
SeleclSSADM 
(alsoa HOOD version) | Analysis, Design 
Smart CASE Analysis, Design 
System Developer | Analysis, Design, Code Generation 
System Architect Analysis, Design, Code Generation 


UK Distributor 


QA Training Ltd, Gloucs. GL7 2EF 


Savant Enterprises, Camsorth LAS 9BX 


Softline Distribution, Sutton SM1 RJH 


Software Construction Company, Royston SG8 5DB. 


Select Software Tools, Cheltenham GL53 90S 
Software Construction Company, Royston SG8 SDD 
Software Construction Company, Royston SG8 5DD 


Real Time Methods Warwickshire W32 4QY 


Approx Price per Single User Copy 
£995-£1795 - PC 


£320-£420 - PC 


10 modules @ £510 each - PC 
£195 - Mac 

£495 - PC 

£195 - PC 

£325 - PC 


£1,145 - PC 


Figure 3 - Example Low cost CASE tools 
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However, all companies, regardless of 
size, should adopt a software develop- 
ment method. The use of a common 
method throughout a company enforces 
rigorous development techniques, a com- 
mon notation and documentation stand- 
ards. CASE tools are the best means of 
imposing such a method on an organisa- 
tion. Thus there is a market for low cost 
CASE tools. 


Low cost CASE is a CASE tool which is 
reasonably priced and does not enforce a 
verbose software development method. 
It often consists of a set of analysis and 
design tools supporting a wide variety of 
techniques and notations, Rather than 
supporting one development method in 
detail, developers are able to combine 
the techniques and notation in a form 
which is suitable for the type of applica- 
tion they are building. For large applica- 
tions, developers can apply a full 
software development method akin to In- 
formation Engineering and SSADM. For 
small projects the combination of Entity 
Relationship Diagrams and Data Flow Di- 
agrams may be enough. Example pro- 
ducts are shown in Figure 3. 


Some products, like POSE, consist of a 
large set of modules. Initially developers 
acquire a small subset of modules and 
acquire more if they require further CASE 
tool facilities. 


Note that the prices above are approxi- 
mate and that multi-user copies are avail- 
able for some of the products. 


Low Cost CASE 


The above products do not have the same 
functionality as a large I-CASE tool such 
as IEF, IEW or Foundation. In fact, many 
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only support analysis and design with 
limited automatic code generation fa- 
cilities, However, the general strategy of 
these products is to satisfy the 80/20 rule, 
ie provide 80% of the functionality of a 
major CASE tool at 20% of the cost. 


The most obvious advantage of these low 
cost CASE tools, over I-CASE tools, is their 
relative cheapness. This means that their 
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If CASE is to 
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successful, it 
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developing small 
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A \\\q]]W}]}]VQAHK 


acquisition is less of a risk for a company. 
Therefore if the CASE tool is not giving the 
desired results then the company’s profits 
will not suffer. Nor will the demise of the 
CASE tool be a major crisis, so the DP 
department will not try to save it by (for 
example) spending more money on con- 
sultancy. 


A further advantage of these low cost 
CASE products is that a company of any 
size can use them to ‘try out’ CASE before 
making a major investment. Introducing 
a CASE tool requires a major culture 
change in an organisation soa pilot study, 
using low cost CASE tools, may result in 
the company learning some valuable les- 
sons. If the initial results with a low cost 
CASE tool are positive the company could 
consider the more expensive I-CASE (In- 
tegrated CASE) products before making a 
final decision on which CASE tool to use. 


The main disadvantage of acquiring such 
low cost CASE tools is their lack of inte- 
gration facilities compared with the major 
CASE tools. Many low cost CASE tools 
cannot be integrated with other software 
tools such as project management tools 
and version and configuration control 
tools. They may also have limited code 
generation facilities so developers may 
have to resort to hand coding after the 
analysis and design phase of an applica- 
tion’s development. Thus the direct rela- 
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ASE 
tionship between the specification and the 
code, which many I-CASE tools preserve, is 
severed, Therefore developers will be re- 
sponsible for ensuring that changes to the 


code are reflected in the design and vice 
versa. 


Despite the above disadvantages, the ap- 
plication of low cost CASE tools can be a 
useful addition to a company’s software 
tool portfolio. However, the acquisition 
of software tools, whether low cost CASE 
or I-CASE, should be within the confines 
of a company’s software development 
strategy. Such a strategy outlines the ap- 
proach to software development within a 
company, regardless of size. It defines the 
techniques and tools developers should 
use and the procedures for managing a 
project including the use of project man- 
agement tools, if appropriate. Ensuring 
that a software development strategy is 
integrated (ie software tools can at least 
share or interchange data) and com- 
plementary is a key way of reducing re- 
dundancy within an organisation and 
maintaining control. 


When considering the acquisition of a 
low cost CASE tool, buyers should look 
beyond the price tag and the plethora of 
techniques it supports and consider how 
the product could be used to support 
their company’s software development 
strategy. Also, despite the relative cheap- 
ness of low cost CASE tools, a company 
must still be convinced of the business 
need for using a software tool before its 
acquisition. 


As with all products, ‘you pays your money 
and you takes your chances’, Using a low 
cost CASE tool, small companies can attain 
many of the benefits of CASE without risk- 
ing the company’s survival. Also, large 
companies can experiment with CASE 
tools without requiring approval from the 
board room for a major investment in a 
new technology. 


EXE 


Patrick McParland is a consultant with 
the Institute of Software Engineering. He 
specialises in the introduction of CASE 
tools in companies of all sizes and recent- 
ly completed a report on the use of CASE 
tools. For further information on any of 
the points made in this article contact the 
Institute of Software Engineering (0232 
738507). 


Thanks are due to Miss Margaret Largey, 
of the Institute of Software Engineering 
Information Service, for her assistance in 
preparing this article. 
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New BOUNDS-CHECKER 2.0 
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* strcpy, memcpy, . . 


Welcome to the age of 
automated memory/heap protection! 


NEW BOUNDS-CHECKER 2.0 is the only complete solution to MS-DOS 
memory and heap corruption problems. 


BOUND-CHECKER 2.0 is a single, easy to use utility that automatically 
detects problems in your programs heap, stack or data segment and 
finds illegal memory accesses outside of your program or in your code. 
In one step, you can quickly and easily flush out some of the most 
Insidious bugs that you regularly encounter as a DOS programmer. 


Using BOUNDS-CHECKER 2.0is simple, there are no changes to be made 
fo your source in any way, and no linking of code or macros into your 
executable. When a bugs found, BOUNDS-CHECKER pops up showing 
you precisely where the problem is. 


One of its innovative NEW features is Smart Mode. Smart Mode uses a 
built-in knowledge base to automatically determine if an out-of-bounds 
accessis legitimate. This eliminates any complex decisions on your part, 
resulting in more power and flexibility than you may have thought 
possible. 


Don't take unnecessary risks with your program or your customers. 
BOUNDS-CHECK before you ship with NEW version 2.0. 


\. 
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(Protection Toots ! 
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* New 2.0 Features « 
¢ Now works with 3rd party memory managers 
¢ Heap, stack and data segment checking 
Smart Mode decides the legitimacy of an access automatically 
¢ Noneed to see assembly code - call stack lets you view source 
of calling routines, 
¢ New Auto Log mode (BC doesn’t pop up) 
¢ Supports C7.0 & Borland 3.1 & VROOM 


Order NOW! Only £129.00 (plus VAT) 


For even more debugging power, BOUNDS-CHECKER 2.0 
integrates with our award-winning Soft-ICE debugger which fea- 
tures powerful 386/486 based breakpoints, Equipped with this 
formidable combination, your de-bugging arsenal is prepared for 
any surprise attack of the DOS Nasties. 

Soft-ICE...£259.00 (pius VAN 

BOUNDS-CHECKER 2.0 & Soft-ICE Bundle 

Only...£329.00 (plus VAN 


BOUNDS-CHECKER AND SOFT-ICE ARE TRADEMARKS OF NU-MEGA TECHNOLOGIES, INC. 


We're making C a Safe Language! 


Call: (071) 833 1022 


RISK = NULL 


Fax: (071) 837 6411 


3-5 Cynthia Street 
London N1 9JF 


System 
Science 


30 DAY 
MONEY-BACK GUARANTEE 


24 HOUR BBS 
603-595-0386 
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Version Control 


Award Yourself VC 


Malindi Lamb sings the praises of Version Control and Configuration Management. 


The terms ‘Version Control’ and ‘Configu- 
ration Management’ have been around in 
the IT industry for some time. In the worlds 
of academia and corporate DP departments 
they are known and respected; but com- 
mercial software houses and application 
developers have only recently begun to 
discover them, 


This has been due to users not under- 
standing the benefits and, more practically, 
to a lack of suitable automated tools, The 
increasing demand for improved software 
quality, highlighted by the recent report by 
the Pyramid consortium entitled Quantita- 
tive Management: Get a Grip on Softwarel, is 
leading to a.demand for information on 
methods of quantifying software quality. 
Both developers and users want to be able 
to benefit from the techniques without 
being buried in bureaucracy. Version Con- 
trol and Configuration Management can 
provide a practical option. 


During the life time of a project, hundreds of 
‘Configuration Items’ (CIs) may be generated: 
requirements specifications, design diagrams 
and documents, software modules, derived 
objects, documentation, change requests etc. 
These CIs will all change many times for a 
variety of reasons - perhaps variants for di 
ferent customers or hardware platforms, 
changes in the requirements or bug fixes. Add 
to that the fact that there may be a number of 
designers and programmers implementing 
those changes and itis easy to see how quick- 
ly you can create a nightmare for the person 
who is trying to manage the changes and 
_ configurations of the product. 


Version Control is at the heart of Configura- 
tion Management. By recording and main- 
taining a complete history of each CT, it can 
answer the questions Who? What? When? and 
Why? - Who made the change? What change 
was made? When was it made? and Why was 
it made? 


Configuration Management is broader, and 
covers management of all the configurations 
of the Cls that make up a product, the process 
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of change, configuration building and re- 
lease management. 


Version Control and Configuration Manage- 
ment are relevant to all stages of the software 
life cycle, but are particularly pertinent to the 
maintenance phase. This is traditionally re- 
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garded as coming at the end of the life 
cycle, but in reality occurs at each stage. 
Maintenance is the most costly part of the 
software development process - estimates 
vary from 50% to 80% of the cost of a 
software project. 


By using Configuration Management tech- 
niques, it is possible to maintain a complete 
history of the versions of every CI in the 
software development process, together with 
informationas to the date/time of any change, 
the author of the change, the reason for the 
change and what the change involved. A 
detailed record is also kept of the constituents 
of any particular release, together with the 
versions of every constituent that makes up a 
release, whether the release is for production 
purposes, for test or any intermediate level 
where a stable state is required to be re- 
corded. Furthermore, it should provide ac- 
cess to any previous version at any time. 


Even the smallest single-user project can 
benefit from the simplest type of Version 
Control, to maintain a version history. For 
larger projects, the benefits of managing the 
development undertaken by different pro- 
grammers to ensure that they do not over- 
write each others’ changes, become even 
more obvious. 


However, manual implementation of such 
techniques can be extremely time consuming, 
and, as a result, it can meet resistance from 
development staff. Since there is no point in 
instituting procedures which are going to be 
ignored or circumvented wherever possible, 
itis apparent that Configuration Management 
Tools are necessary if Configuration Manage- 
ment is to become accepted generally, Such 
tools improve productivity by ensuring 
work done is not lost, assist in tracking 
down bugs and automate tedious manual 
tasks. 


They offer a variety of additional functionality 
including Change Control, which automate 
change requests. This encompasses all aspects 
of controlling change to CIs, in terms of access 
and Modification Requests (MRS). These are 
controlled by recording and defining the whole 
life cycle ofan MR fromreceipt, through accept- 
ance to closing, facilitating assignment to pro- 
grammers, and monitoring of progress at all 
times. 


All good Configuration Management Tools 
incorporate powerful report generators 
which produce reports providing users with 
detailed information on the software devel- 
opment cycle. 


The issues of reuse and OO must nécessar- 
ily promote the techniques, because it will 
be impossible to manage a library of objects 
and reuse them without having a very com- 
prehensive Configuration Management 
system which can identify which versions of 
which objects were used in a particular 
package. Furthermore, with the increasing 
interest in BS5750 quality standards, Ver- 
sion Control and Configuration Manage- 
ment will have to be more widely adopted, 
resulting in more reliable, eficient produc- 
tion of software. 


EXE] 


Malindi Lamb is the Managing Director of 
Intasoft Limited. Intasoft’s SMS package is 
one of the version control systems reviewed 
by Cliff Saran elsewhere in this issue. 


The Right Tools for the Right Job 


TbxSHIELD™ — the 
fastest way to add 
new and innovative 
toolbox controls to 
an application. 


Tbx SHIELD from Stirling Group provides a high level, object oriented tool 
box library to permit the creation of sophisticated tool box controls like — 
VCR Bar, Drag and Drop, rotating ToolCube, Toolbar, Button Bar and 
scrollable virtual Toolbox. 


Call back functions allow you to manage application code which 
responds to toolbox controls. 


TbxSHIELD is available for Windows and Presentation Manager. Call for 
a demo disk. 


TbxSHIELD for Windows or OS/2 


| ® 
c-scape? 4.0  LiJIAINIT _C-scape 
The latest release of the best selling character/graphics based screen 
interface library in the UK. C-scape is run-time royalty free and prices 
include source code and the Look & Feel™ Screen Designer. 


C-scape is the most flexible interface package for text or graphics based 
applications with such powerful features as scrolling windows, mouse 
support, menus, text editor, help, data entry and much more. C-scape’s 
object oriented architecture makes it easy to integrate with any other C 
library and applications port without modification across DOS, extended 
DOS, OS/2, UNIX, AIX, X Windows, QNX and VMS. 


DOS, OS/2 — £370 + VAT 
UNIX — £1065 + VAT 
VMS — £1760 + VAT 


£245 + VAT 
KnowledgeMan release 3 


Complete 4GL tl ® indbs 
Development Environment Since 1979 


The only complete, synergistically integrated 4GL development 
environment, from mdbs. KnowledgeMan includes a complete 
procedure language, relational data management, spreadsheet, 
business graphics, text processing and much more, Setting 
KnowledgeMan apart from other products are BLOBs (Binary Large 
OBjects), a compiler, natural language interface, CodeView style 
debugger, SQL and a host of innovative features. First launched in 1984, 
the Best gets Better. 


KnowledgeMan is aimed at the sophisticated user and includes import/ 
export support and an interface to C. 


DOS, OS/2 S/U — £675, LAN — £1610 + VAT 
SUN and VAX prices on request. 


Build multi-megabyte 
DOS programs with 
Phar Lap 286!DOS Extender™ 


With the 2861 DOS Extender and your Microsoft C, Borland C++ or MS 
Fortran compiler you have all the tools necessary to quickly build 
protected mode applications — often by relinking without making source 
code changes. Protected mode applications can be built that access up to 
16 megabytes of memory on any DOS 80286, 386, 386SX or i486 PC. 
2861DOS Extender is also compatible with both Borland’s Turbo 
Debugger and Microsoft's linker and CodeView debugger. 


Software Development Kit £330 + VAT 


InstallSHIELD 


Build Bullet-Proof Installation Programs 


Used by some of the world’s leading Windows and Presentation 
Manager applications, InstalISHIELD is available to create professional, 
bullet-proof installation programs. InstallSHIELD’s powerful and easy-to- 
use script language provides an array of installation and file handling 
functions that you can use to create a wide variety of intelligent 
installation and file distribution applications. 


Call for a demo disk. 


InstalISHIELD for Windows 
InstalISHIELD for OS/2 


£245 + VAT 
£505 + VAT 


386|1DOS Extender” 
the ultimate in 
32-bit power 


Phar Lap 3861DOS Extender turns DOS into a true 32-bit operating 
system with a flat 32-bit address space. A program can access all the 
memory available in the machine — up to 4 gigabytes. 3861 Extender runs 
on any DOS based 80386, 386SX or i486 PC and has been used in over 
800 applications including AutoCad 386 and IBM's Interleaf Publisher. It 
is backed by a full complement of 32-bit languages including C, C++, 
Fortran, Pascal, Ada and Assembler. With true 32-bit performance 
workstation-class applications can be built for the PC. 


Software Development Kit £330 + VAT 


Magna Charter II relieves the 
pain of drawing charts 


MagnaCharter II for Windows lets you build any kind of chart in minutes 
and includes all standard flowcharting symbols which are displayed as 
icons — or add your own, Use the crowsfeet for database schemas. 
Features are accessed by drop-down menus, dialog boxes and multiple 
windows with a wide choice of text styles and sizes. Editing is simple ‘cut- 
and-paste’. MagnaCharter || appears as a 99x99 spreadsheet. A wide 
range of printers is supported as is PostScript. 


A demonstration disk is available. 


MagnaCharter II for Windows 


£160 + VAT 


Other Products Distributed and Supported 
by Systemstar 


Raima Data Manager — DOS, Windows, OS/2, QNX, UNIX, VMS __ call 
Raima Object Manager — DOS, Windows, OS/2, QNX, UNIX, VMS call 


WKS Library — DOS £145 
APT Reporting — Windows £370 
DataDesigner — DOS, UNIX call 
C++/Views — Windows — £299, OS/2 PM — £649, UNIX Motif — £999 
ProtoView — Windows £299 
ProtoGen — Windows £55 
DataTable — Windows £215 
DbxSHIELD — Windows — £335, OS/2 — £505 


LogSHIELD — Windows — £335, OS/2 — £505 
DemoSHIELD — Windows — £415, OS/2 — £505 
MemSHIELD — Windows — £335, OS/2 — £505 


Please check price at time of order and add VAT 


For more information 
call Systemstar on (0992) 500919. 
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Product and company names are trademarks of thelr respective holders. 
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THE RED HOUSE BLUECOATS HERTFORD SG14 1AX 
TELEPHONE: (0992) 500919 FACSIMILE: (0992) 554261 


MICROSOFT 
AND BORLAND 


STAND BEHIND 
LIALK/V. 


If you're looking 
for the fastest, easiest 
way to develop and 
maintain applications, 
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users in the Com- 
puterworld survey. 
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strategy for the 1990's. 
It’s not surprising, 
when you consider 
that our top-rated 
reusability of code is 
the essence of object- 
oriented programming. 
And that our unequaled 
ease of maintenance is 
the feature considered 


those, it’s no wonder a 
company like IBM really 
does stand behind us. 


IBM TAKES A STAND, 


Because of the 
leading edge technology 
and superior quality of 
Smalltalk/V, Digitalk is 
now one of only eight 


100% PURE OBJECTS. 
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To receive 
an informative white paper on 
Smalltalk/V object-oriented 
technology, call 071 436 9481. 

If you're looking for the 
fastest way to develop applica- 
tions, get behind the winning 
technology for the 1990's. 


DIGITALK 


TIFF Files: 


TIFF Files 


How to Read and Write Them 


Graeme Webster explains one of the most popular file formats used to store graphics images. 


One of the main problems with computer 
graphics is not so much the absence of stand- 
ards as the presence of too many! To be sure, 
attempts are made to introduce standards for 
the exchange of graphical information, such 
as GKS (Graphical Kernel System, ANS 
X3.124-1985) or PHIGS, but the rapid changes 
in the technology such as the introduction of 
24 bit colour, zbuffers for rendering and so 
on, have made it hard for the standards ma- 
kers to keep pace with these changes. 


There is, of course, a view which says that 
at a time of rapid technological develop- 
ment the too early imposition of a standard 
serves only to stifle innovation and is there- 
fore not a good thing. On the other hand, the 
cynic might say that it is in the manufacturers’ 
interests to try to ensure that customers are 
restricted to proprietary formats so that, once 
caught, they are compelled to stay with that 
manufacturer's software. 


Types of Image File 


There are three basic kinds of graphics file. 
The extremes are, on the one hand, those 
in which the data is essentially in the form 
of lines and curves as typified by CAD data, 
referred to as vectorfiles and those in which 
the data is a mapping of the pixels which 
go to make up a raster display of an image 
and known as raster files. Finally, the term 
meta file is used to describe files which 
contain a combination of the two kinds of 
data. In practice, applications tend to adopt 
one or other of the first two file types, vector 
files for CAD and line drawing, raster files 
for images, pictorial graphics, electronic 
painting and the like. 


This article is concerned with one of the 
most popular of the raster file types the 
‘Tagged Image File Format’ universally 
known as the TIFF format. These files 
generally have a .7/F DOS file extension. 


Work on the definition of the TIFF format, 
as a non-proprietary standard for the inter- 
change of raster image data, was started in 
1986 by the Aldus Corporation. Version 6.0 
of the specification came out in 1991. Aldus 
still administers the core specification, but 
a number of other big name companies, eg, 
Hewlett-Packard and Microsoft, are also in- 
volved in its current development. TIFF 
provides a general purpose format which is 
compatible with a wide range of image 
processing systems. It is, probably, the 
most widely supported scanned-image file 
format in use on personal computers. The 
open ended nature of the tag system used 
means that the format is fairly future proof, 
and should be capable of supporting in- 
creasingly sophisticated hardware and ap- 
plications without fundamental alteration. 
TIFF is not dependant on any particular 
hardware platform or operating system and 
is used on IBM PC compatible, Apple Ma- 
cintosh, UNIX, NeXT and other environ- 
ments, 


TIFF Structure 


Although most TIFF files contain only a 
single image, multiple images are permitted 
in one file (for example, I use this feature 
to keep together a full size image and a 
miniature of it, which can be used in an 
image browser). To allow for this possi- 
bility, the TIFF file consists of a header that 
occupies the first eight bytes, then one or 


more subfiles, one for each of the images 
contained in the TIFF file. Referring to Fig- 
ure 1, in which the size in bytes of entries 
is given in square brackets, each subfile 
contains an Image File Directory (IFD), ad- 
ditional offset information and the image 
data itself. The IFD is a set of 12-byte rec- 
ords (tags). Together these describe the 
characteristics of the image, how big it is, 
how the bytes of image data are to be 
interpreted and so on. 


The Header Field 


The header is the only part of a TIFF file 
which is in a fixed location. Figure 2 shows 
the header fields and their offsets from byte 
0 of the file. 


The byte order is either the two ASCII char- 
acters IJ (49h 49h), signifying Intel byte 
ordering, or MM(4Dh 4Dh), signifying Moto- 
rola byte ordering. This distinction is made 
because, for 16 and 32-bit quantities, Inte 
processors treat the first byte as the least 
significant whereas Motorola treats it as the 
most significant. TIFF writers are allowed to 


TIFF header (8) 
Pointer to first IFD [4] 


Tag count = n (2) 
Tag 0 [12] 
Tag 1 [12] 
Tag 2 (12) 


___Tag3[t2}_ 


Saas chee 
Pointer to next IFD or 0 if no more IFDs [4 


Possibly data for tags requiring 
more than four bytes [?] 


Possible palette information (?] 


Image bit-map (7] 


a 


Figure 1 - 
General structure of a TIFF File 


Byte order [2] 


bytes 2,3 
bytes 4,7 


‘Version number’ [2] 


Pointer to first IFD [4] 
oe 


Figure 2 - File Header 
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adopt which ever scheme is most conveni- 
ent, telling the world what it has done by 
putting IT or MM in bytes 0 and 1. TIFF 
readers are not allowed that luxury and 
must recognise and deal with either case. 


The next two bytes of the header are always 
‘42’, This is not a true ‘version number’ but, as 
the Specification says, is chosen for deep phil- 
osophical significance (ie Douglas Adams). 
The Specification also gives the practical ad- 
vice that if think you have a TIFF file and these 
bytes are not ‘42’ then the nature of the file 
specification will have been so radically 
hanged that you should give up trying to 
interpret itat that point. Indeed, the combina- 
tions of ‘I’ and ‘42’ or‘MM’ and ‘42’ canusually 
be taken as prima facie evidence that you are 
dealing with the genuine article. 


° 


Finally, bytes 4 to 7 are a 32-bit pointer to 
the location of the first byte of the first IFD. 
If there are additional subfiles, these are 
located through a similar 4-byte pointer 
placed at the end of the previous subfile. 
The last subfile is marked by a zero pointer. 
All pointers and offsets in TIFF files are 
absolute byte counts and refer to the start 
of the file, thus the first byte of the file has 
an offset of 0. 


The Image File Directory 


An IFD has three components appearing in 
a fixed order: a two byte count giving the 
number of tags which follow; the tags, each 
2 bytes long; and the byte pointer to the 
start of the next IFD. This is shown diagram- 
matically in Figure 3. IFDs can be placed 
anywhere in the file provided that they 
begin on a 2 byte boundary. 


The Tag Fields 


There are approximately 60 distinct tag 
field types defined in version 6.0 of the TIFF 
specification. Some of these are for rather 
specialised uses, such as facsimile trans- 
mission or for colour separation, and are 
beyond the needs of this introductory ar- 
ticle. However, a dozen or so of them are 
quite essential and appear in almost all TIFF 
files. Each tag is made up of four parts: the 


Entry count = n [2] 
Tag 0 [12] 


Tag 1 [12] 


Tag n-1 [12] 
Offset to next IFD [4] 


Tag data too long to fit into a tag [/ength*type] 


yeah 


Figure 3 - Image File Directory 
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TIFF Files 
| Serial number Type Length | Data or offset 
2 bytes 2 bytes 4 bytes 4 bytes 


Figure 4 - Tag Structure 


tag serial number, the type of the tag value, 
the number of values in the tag (usually 
rather misleadingly referred to as the 
‘Jength’) and the tag data or an offset. If the 
tag value is less than four bytes then the 
value is stored in the tag itself. If the value 
is too long to go in, the four bytes in the tag 
are a pointer to the file location where the 
actual value is to be found. Figure 4 shows 
the components of a 12 byte tag. 


Serial Number field 

The Specification requires that tags appear 
in an IFD in ascending order of tag type 
number. Public tag serial numbers start at 
254 (FEh) and run to 321 (141h) and be- 
yond, Private tag serial numbers, starting at 
32768 (8000h) may also be allocated by the 
TIFF Administrator (and of course you can 
invent your own private tags, on your own 
head be it!). The use of private tags is dis- 
couraged, however, as they can cause con- 
fusion for some readers and should only be 
used as a last resort to cater for some really 
eculiar situation. 


Type field 


Five data types are allowed, These are tabu- 
ated in Figure 5. Usually only one data type 
is associated with any particular kind of tag. 
However, for certain tags more than one 
type of data is allowed. For example, those 
specifying image width and image height 
can be either LONG (32 bits) or SHORT (16 
bits). Preferred practice in this case would 
be for a TIFF writer to use the SHORT type 
unless otherwise necessary. A TIFF reader, 
however, cannot just assume from the tag 
serial number what type of data it is being 
offered; it is necessary for it to check the 
type field and act accordingly. 


BYTE entities are 8-bit unsigned integers. 
ANSII entities are NULL terminated strings 
of 8-bit bytes that store ANSII codes. The 
length includes the NULL. In fact the NULL 
is not strictly necessary, but it makes things 
a bit easier for C programmers. A further 
complicating detail is that, if necessary, an 
ASCII string is padded out beyond the 
NULL to make the total number of bytes 
even; however, in this case the extra pad- 
ding bytes are not included in the length 
count. RATIONAL type is taken to be the 
ratio of two LONGs, the first representing 
the numerator of the fraction, the second 
the denominator. RATIONALs always re- 


quire to be pointed to by an offset pointer in 
the tag data field. 


Length field 


This field contains the length of the item 
pointed to by the tag, counting in units of 
the data type of the tag, So, if the data type 
were to be LONG, ie 4 bytes, and there were 
16 of these, the Length entry would be 16 
but the data pointed to would be 16 x 4 = 
64 bytes long. 


Data or Offset field 


The last four bytes either contain the tag’s 
actual data or, if it is more than four bytes 
long, a 32-bit pointer to where in the file the 
actual data can be found. You determine 
which case you have by whether or not the 
product of Length and the byte size of the 
data type is less than or equal to four. If the 
type is RATIONAL the field always contains a 
pointer. Frequently the data type is SHORT 
and the Length one (an example is the image 
width information). In these cases the two 
bytes of data are left justified in the field. The 
other two bytes will not contain any signifi- 
cantdata, but ifyou are a TIFF reader you can 
not assume them to be zero - the writer 
may have put a secret message there! 


As previously noted, some tags are in- 
tended for specialist use (such as fac- 
simile transmission and document 
storage and retrieval) while others are no 
longer recommended. Others appear in 
almost every TIFF file. As a TIFF reader is 
not allowed to assume defaults for any tag 
information, a TIFF writer must supply all 
the necessary tags to make unambiguous 
interpretation of the image possible. The 
most crucial tags which are likely to be 
encountered when dealing with images 
are listed below, with their official titles 
printed in italics, 


254 New subfile type. A data filed value of 
zero means that the fill contains a full size 
image. This tag is the first one in the IFD. 


256 Image Width in pixels. This is the only 
way a TIFF reader is going to know how big 
the image is and so is essential 


257 Image Length, also essential. 


258 Bits Per Sample. A black and white ‘Line 
Art’ image will have only one bit per 


That's right: a nice, fat 32 bits! Available both 
for Windows 3.1 and DOS, LPA 386-PROLOG 
gives you an easy to use, menu and window 
based programming environment. And thanks to 
the genuine 38-bit flat model architecture, your 
applications can directly address up to 4G 
(4096M) of memory (64M under Windows). 
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sample, these being packed eight to the 
byte. Typical 256 colour palette data will be 
eight bits per sample. 


259 Compression. There are five 'official’ 
compression schemes and several private 
ones. Compression type 1 is ‘no compress- 
ion’, For colour images the most common 
schemes are official method 5, a Lempel- 
Ziv & Welch (LZW) compression using 12- 
bit codes and method 32773, PackBits 
compression, originally a private scheme 
but now in common use. 


262 Photometric Interpretation. This tag is 
required for all images as it tells the reader 
how to interpret the values in the bit map. 
Currently five values are defined, The ones 
most likely to be of interest are 2, RGB data 
with the minimum sample values repre- 
senting minimum intensity, and 3, palette 
colour. 


270 Image Description. Title of the image as an 
ASCII string, Intended for information only. 


271 Make. The manufacturer of the scanner, 
frame grabber or whatever as an ASCII 
string. Intended for information only. 


272 Model. The model number of the scan- 
ner, frame grabber or whatever as an ASCII 
string. Intended for information only. 


273 Strip Offset. This is a required tag as 
it is the only way the TIFF reader has of 
knowing where the image data starts. The 
data may be conceptually divided into a 
number of strips each with its own 
pointer. This can greatly facilitate data 
compression if that is being invoked. Of 
course, if there is more than one strip, the 
multiple pointers will not go into the tag’s 
data field so the tag contains a pointer to 
a block of 32-bit pointers to strips. If there 
are multiple strips, there will also need to 
be tags 278 and 279. 


277 Samples Per Pixel. For monochrome 
and palette colour this is one, for 24-bit 
colour it is 3. 


278 Rows Per Strip and 
279 Strip Byte Count tags. 


282 X Resolution. The number of pixels 
per Resolution unit in the x-, ie image 
width, direction. This tag is used for siz- 
ing images for printing. The data type is 
RATIONAL. 


283 Y Resolution. The number of pixels per 
Resolution unit in the y-, ie image length, 
direction. The data type is RATIONAL. 
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284 Planar Configuration. This tag is required 
for 24-bit colour. If the tag data value is 1 the 
image data is in RGB triplets, if the tag data is 
2 the image dlata is givenas first the red plane, 
then the green and finally the blue. 


296 Resolution Unit. This tag is used with X 
Resolution and Y Resolution. Data is of type 
SHORT. A value 1 means that there are no 
absolute units; 2, units are inches; 3, units 
are centimetres. 


305 Software. The name and release number of 
the package which created the image as an 
ASCII string. Intended for information only. 


306 Date Time, as an ASCII string. Intended 
for information only. 


» 


315 Artist. Artist's name as an ASCII string. 
Intended for information only. If you wish 
to include a copyright notice in the file a 
good place to put it is immediately after the 
eight byte header, adjusting the pointer in 
bytes four to seven to jump over it. 


316 Host Computer, as an ASCII string. In- 
tended for information only. 


317 Predictor. This tag is used with LZW 
compression, Data is of type SHORT. A 
value 1 means that no prediction scheme is 
used before coding. 


320 Colour Map Offset. This tag must be 
included inall files of palette colour images. 
The tag data is a pointer to where the palette 
information can be found. The palette itself 
is stored as a set of unsigned 16-bit red 
values, followed by a set of green values 
and finally a set of blue values, Black is 0,0,0 
and white 65535,65535,65535. 


The Sample Code 


Producing a TIFF writer to incorporate into 
your own programs is not too difficult. De- 
cide on what kind of image you are going 
to export, eg uncompressed palette colour, 
and provide the necessary tags to define it. 
Producing a really general TIFF reader is a 
much harder task. For a particular applica- 
tion the range of image types and sources 
will be limited. This knowledge can be used 
to simplify the reader so that it deals with 


Ny 


TIFF Files 


other ones. The accompanying code, in 
Figure 6, is a kit of subroutines, in Microsoft 
C, out of which you should be able to build 
TIFF readers and writers suitable for many 
purposes. The interesting bits are: 


ReadTiffFile(). This is the principal 
subroutine of the reader, It reads uncom- 
pressed 8-bit palette colour or 24-bit RGB files 
with the file handle InF ile, in either Intel 
or Motorola ordering, into a global array 
called Image. If you are using one of the 
new 32-bit flat address space compilers such 
as Watcom C 9.0 or the Intel C CodeBuilder 
Kit, you will have no difficulty in declaring a 
big enough array to hold the whole image. 
For users of 16-bit compilers it will be necess- 
ary to doctor references to Image [] []. For 
example, the picture could be dealt with in 
strips, or possibly the data might simply be 
written to the display device and stored there. 
Notice that though the subroutine reads pa- 
lette data into the global array Pa- 
lette[] [], itdoes not reset the hardware 
palette. This will have to be done by an 
appropriate subroutine call. 


Some TIFF writers seem to ignore the fact that 
palette data is supposed to be 16 bits and just 
store 8-bit entries, Treating these as the least 
significant part of a 16-bit value leads to a 
palette full of zeros and a display that is 
comprehensively black. Read-TiffFile O 
makes the assumption that if the most signifi- 
cant 8 bits are zero, the odds are you have 
degenerate palette data and attempts a fix by 
eft shifting 8. 


ReadPixelRow0. At the present time most of 
us cannot display 24-bit colour so what to do 
with it presents a bit ofa problem, This subrou- 
tine employs a trick which you may find useful, 
t turns them into 8-bit grey-scale images using 
the weighting factors used in television to cal- 
culate the luminance from the red, green and 
blue signals. SetPixel (x, y, Pp) placesa 
pixel of value p on the screen at location (4, 9). 


WriteTiffFile (). This is the princi- 
pal subroutine of the writer. It writes an 
uncompressed 8-bit palette colour files 
with the handle Out File, in Intel orde- 
ring, froma global array called Image. The 
image size is given by the globals HRes 
and VRes, the software palette is in the 


images of the appropriate kind and rejects | global Palette [256] [3]. 
BYTES PER NUMB EE OF VALUE! 
eS VALUE Gaasiise | Regurans 

1= BYTE 1 4 >5 

2= ASCII 1 4 25 

3 = SHORT 2 2 23 

4=LONG 4 1 S32. 

5 = RATIONAL 8 0 il 


Figure 5 - TIFF Data Types 
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CALL FOR INFORMATION 
about the MicroHelp 


products for Microsoft 
QuickBASIC, PDS and the 
new Visual Basic for DOS 


Ov ee £/ 


//Subroutines for TIFF readers and writers 


#include <io.h> // File 1/0 functions 

#include <stdio.h> // for printf () 

#include <string.h> // for strepy() 

fidefine BYTE unsigned char 

#define UINT unsigned int 

fdefine CLAMP (v,1,h)\ 

(((v) <(1)) 2 (1) (Cv) > (Ch) ) 2 0h) = (vd) 

BYTE Stg(256), // general purpose string 

Image(](], // array for holding image 
// See text 

Palette(256] [3]; // software palette 


int InFile,OutFile, // file handles 
// TIFF globals 
BitsPerSample, FirstTag, HRes 
ModeIorM, NTags, PhotometricInterp 
PlanarConfig, SamplesPerPixel, 
StartRaster, StartPalette, VRes 
TitleLoc; 

// You supply this from a graphics lib 

void SetPixel(int x, int y, int col); 


void Readi(int handle, BYTE *ch); 
void Read2(int handle, UINT *i); 
void Read4(int handle, UINT *i); 
void ReadHeader(int handle, 
int *ifdoffset); 
ReadPixelRow(int inhandle 
int row,int hres); 
ReadTag(int handle, UINT *tag 
UINT *type, UINT *length, 
UINT *value); 
ReadTiffFile (void) ; 
TiffError (BYTE *text); 
Writel (int handle, BYTE ch); 
Write2(int handle, UINT i); 
Writed4 (int handle, UINT i); 
WriteHeader (int handle); 
WriteTag(int handle, UINT tag 
UINT type, UINT length, 
UINT value); 
void WriteTiffFile (void); 


VIITTLTATT TAT ATTA TTT ALLA A TAA 


void Read (int handle, BYTE *ch) 
( BYTE buffer(1]; 


read(handle,buffer,1); *ch=buffer(0); 


void 


void 


void 
void 
void 
void 
void 
void 
void 


) 
TUVLTTTTTLLLLAT TATA ATA 


void Read2(int handle, UINT *i) 
( BYTE buffer(2); 


read (handle, buffer, 2); 
if (ModeTorM==0x4949) 
*i=buffer[0) | (buffer (1) <<8); 
else 
*iebuffer(1) | (buffer (0)<<8); 


) 
PILTTLATTTTTATAL TAAL LATTA AAT 


void - Read4(int handle, UINT *i 
{ BYTE buffer[4); 
read (handle, buffer, 4) ; 
if (ModeTorM==0%4949) 
*isbuffer(0) | (buffer [{1]<<8) 
(buffer [2] <<16) | (buffer [3] <<24); 
else 
*isbuffer(3] | (buffer (2]<<8) | 
(buffer {1} <<16) | (buffer [0] <<24); 


} 
VILITILTTTALTAL TATA TATA TL 


ReadPixelRow(int inhandle 
int row,int hres) 
( BYTE buffer (4800); 
int i,j,n,we 
// for the moment if data is RGB 
// deal only with triads 
if (PlanarConfig==2) return. 
if (PlanarConfig==1) 
{ n=read(inhandle, buffer, 3*hres); j=0; 
for (i=0;i<n;it=3) 
( wCLAMP ( (299*buf fer [i] + 
587*buffer [itl] + 
114*buffer(i+2]) /1000, 0,255); 
Image(j] [(row]=w; SetPixel(j,row,w); 
jets 


void 


} 
} 


else 
{ n=read(inhandle, buffer, hres) ; 
for (i=0;i<n;itt) 
{ w=buffer(i]; Image[i} [row] =w; 
SetPixel (i, row, w); 


} 
} 


y 
VITTILTLTTAT LTA LAT TATA AL 


void ReadHeader (int handle, int *ifdoffset 
{int on; 


Read2 (handle, sModelorm) ; 
if (ModeIorM!=0%4949 && ModeIorM!=0x4d4di 


TiffError ("Input is not a TIFF file"); 
Read2 (handle, &n); 
if (n!=42) 


TiffError ("Input is not a TIFF file"); 
Read (handle, ifdoffset) ; 


} 
LL 
void ReadTag(int handle,UINT *tag, 

UINT *type,UINT *length 

UINT *value) 
(int dummy; 


Read2 (handle, tag); 
Read2 (handle, type) ; 
Read4 (handle, length) ; 
// allow for reading one 
// left justified 16 bit SHORT 
if (*type==3 && *length==1) 
( Read2 (handle, value) 
Read2 (handle, édummy) ; 
} 
else 
Readd (handle, value) ; 


) 
FULTTATAT TAAL AAT LATTA AAA AAA 
void —_ ReadTif fFile (void 
{ int b,curentposinfile,g, i, ifdoffset, j 
length, ntags, pal, r, row, 
rasterstart, tag, type, value; 
// header 
BitsPerSample=HRes=Photomet ricInterp= 
PlanarConfig=SamplesPerPixel= 
StartPalette=VRes=-1; 
Readileader (InFile, &ifdoffset) ; 
lseek (InFile, ifdoffset, SEEK_SET); 
// Tags in directory 
Read2 (InFile, éntags) ; 
for (i=0;icsntags; i++) 
{ ReadTaq(InFile, é&tag, &type 
length, &value) ; 

switch (tag) 

{ case 0x100: 
HRes=value; 
break; 

case 0x101: 
VRes=value; 
break; 
case 0x102: // Bits Per Sample 
if (length==1) // 8 or 24 
BitsPerSampl 
else if (lengt: 
{ curentposinfile=tell(InFile); 
lseek (InFile, value, SEEK_SET) ; 
Read2 (InFile, &r); 
Read2 (InFile, &); 
Read2 (InFile, &b) ; 
lseek (InFile, curentposinfile 
SEEK_SET); 
if (r==8 && g==8 && b==8 
BitsPerSample=24; 


// Image Width 


// Image Length 


) 
if (BitsPerSample==~1) 
TiffError ("Input data must be\ 
in 8 or 24 bits/pixel format"); 
break; 
case 0x103: // Compression 
if (value!=1) 
TiffError("Input data must be\ 
uncompressed") ; 
break; 
// Photometric Interpretation 
// 2 for RGB if not assume 3 
// ie palette colour 
case 0¥106: 
if (valu 
Tifferror 
transparency masks"); 
PhotometricInterp=(valu 
break; 
case 0x111: // Strip Offset 
// Points to raster data 
if (length==1) rasterstart=value; 
else 
// Image is defined as a set of strips; 
// hope that they are consecutive and 
// contiguous we can simply find where the 
// first one begins and start reading 
// from there. 
{ curentposinfile=tell (InFile); 
lseek (InFile, value, SEEK_SET) ; 
Read4 (InFile, &rasterstart); 
lseek (InFile, curentposin- 
file, SEEK_SET); 
) 
break; 
case 0x115: // Samples Per Pixel 
// 1 for 8 bits/pixel 
// 3 for 24 bits/pixel 
if (value==1 || value= 


4) 


Can't deal with\ 


3) 


TIFF Files 


SamplesPerPixel=value 
else 
TiffError ("Input data must have\ 
1 or 3 samples per pixel"); 
break; 
case Oxllc: // Planar Configuration 
// 1 for RGB triad 2 for red plane 
// followed by green plane followed 
// by blue plane 


PlanarConfig=value; 
break; 
case 0x140: // Colour map offset 
StartPalette=value; 
break, 
default: ; 
} 
} 
if (BitsPerSample==-1 || HRes==-1 | 
vRes==-1 || SamplesPerPixel==-1 | 


(PlanarConfig==-1 66 
SamplesPerPixel>1)) 
TiffError ("Insufficient data in\ 
TIFF file tags"); 
// The input TIFF file has a palette 
if, (StartPalette!=-1) 
{ lseek(InFile, StartPalette, SEEK_SET); 
for (j=07 j<37 j++) 
for (i=0;1<256;i++) 
{ Read2(InFile, épal); 
Palette(i}(j]=(pal>=256) 2 
pal : pal<<8; 
// This trick is necessary, as some 
// products (eg PBrush) appear on occasion 
// to put the palette info out in the 
// range 0-255 rather than 0-65535 
) 
// reset the hardware palette here 
// using the values in Palette()(j 
) 
// caster data 
lseek (InFile, rasterstart, SEEK_SET) ; 
for (row=0; row<VRes;rowt+ 
ReadPixe1Row(InFile, row, HRes) ; 
close (InFile); 


) 
FUTTELTTTTLTTT LTT LAAT ATTA TAA 


void TiffError (BYTE *text) 
{ printf ("%s\n", text); 
close(InFile); close (OutFile); 


) 
VITLETTTATAT LATA TATA TAT TAA TALL 


void Writel(int handle, BYTE ch: 
{ BYTE buffer{1); 


buffer [0)=ch&0xff; 
write (handle, buffer, 1); 


) 
TUTTTTTTATATTA ALTA TATA AAT AA AL 
void  Write2(int handle, UINT i) 
{ BYTE buffer(2); 
buffer(0)=is0xff; buffer(1)}=(i>>8) eOxff 
write (handle, buffer, 2); 


) 
TITTTLITTALTAT LATTA ATTA 
void Write4(int handle, UINT i) 
{ BYTE buffer(4); 
buffer (0)=i80xff; buffer(1]=(i>>8) Oxf fs 
buffer (2}=(i>>16) &0xf£; 
buffer (3]=(i>>24) &Ox£f; 
write (handle, buffer, 4); 


} 
LITTTTTTATAL TATA AAA AAA TATA AA TAA 


void WriteHeader (int handle) 
( BYTE notice (32); 
int 9 1,n; 


strepy (notice, "Copyright MCMXCII"); 
// number of tags in directories 
NTags=12; 
// calculate where things will go 
// 4 bytes for MM and 42 
TitleLoc=8; 
// length of copyright notice 
// including the NUL 
StartRaster=TitleLoc 
+32; 
// size of image 
StartPalette=StartRaster 
+VRes*HRes; 
// size of palette, 768 off 2 byte values 
FirstTag=StartPalette 
+1536; 
Write2 (handle, 04949) ; 
Write2 (handle, 0x002a) ; 
Writed (handle, FirstTag) ; 
write (handle, notice, 32); 


i 
VILTETTTTTA ELT TAT TATA TATA TAA TAT AA 


Figure 6 - Sample TIFF subroutines 


(Continued on page 40) 
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TIFF Files 


void  WriteTag(int handle, UINT tag, 
UINT type, UINT length, 
UINT value) 
{ Write2 (handle, tag); 
Write2 (handle, type) ; 
Writed (handle, length) ; 
switch (type) 
{ case 3: 
if (length==1) 
{ Write2 (handle, value) ; 
Write2 (handle, 0); 
} 
else 
Writed (handle, value); 
break; 
case 4: 
break; 
default: 
} 
) 
FALTLLTTATA ALATA TAA AAA TAA AAA AT AAA AA AT 
void WriteTiffFile (void) 
{ BYTE buffer(2048); 
int. ¢,4,35,"7 


Write4 (handle, value) ; 


Write (handle, value) ; 


WriteHeader (OutPile); 
// write raster data to file 
seek (OutFile, StartRaster, SEEK_SET) ; 
for (r 
{ for 
buffer [c)=Image(c] (r]7 
write (OutFile, buffer, HRes) ; 
} 
// write palette data 
seek (OutFile, StartPalette, SEEK_SET) 
ijt) 
715256; i++) 
Write2 (OutFile, Palette(i} (5))7 
// now write tags etc 
seek (OutFile, FirstTag, SEEK_SET); 
Write? (OutPile,NTags) ; 
// NewSubfile, main image 
WriteTag(OutFile, 254,0x04,1,0); 
// ImageWidth 
WriteTag (OutFile, 0x100,3,1,HRes) ; 
// ImageLength 
WriteTag(OutFile, 0x101, 3,1, VRes) 
// BitsPerSample (8) 
WriteTag (OutFile, 0x102,3,1,8) 


lette); 
// no more TIFF stuff 


// Compression (none) 
WriteTag (OutFile, 0x103,3,1,1); 
// PhotometricInterp (palette 
WriteTag (OutFile,0x106,3,1,3); 
// title 
WriteTag (OutFile, 0x10e,2,32,TitleLoc) ; 
// StxripOffset, points to where 
// raster data starts 
WriteTag(OutFile,0x111,4,1,StartRaster) ; 
// SamplesPerPixel (1) 
WriteTag (OutFile,0x115,3,1,1); 
// RowsPerStrip 
WriteTag (OutFile, 0x116,4,1,VRes) ; 
// StripBytesCount 
WriteTag (OutFile, 0x117,4,1,HRes*VRes) ; 
// Colour map offset 
WriteTag (OutFile, 0x140, 3,768, StartPa- 


Writed (OutPile, 0); 
close (OutFile); 


WriteHeader (). This subroutine calcu- 
ates where things are to go in the fileand then 
writes out the TIFF header, allowing for the 
inclusion of a copyright notice. Just to be dif- 
ferent, the image bit map is placed immediately 
after the copyright notice, the palette after the 
image and the tags at the end of the file. This 
emphasises the point that, apart from the first 
eight bytes, there are no fixed locations in TIFF 
files. In practice it is probably better to put the 
tags before the image bit map, especially if the 


file will be read off a floppy, otherwise time 
will be wasted reading down the file for 
them. 


[Exe] 


Dr Graeme Webster was formerly Head of 
Department of Computer Science and later 
Deputy Director, Academic, of Teesside 
Polytechnic. He has been involved with 
computer graphics for the last 20 years with 


Figure 6 - Sample TIFF subroutines (Continued) 


an especial interest in 3D visualisation for 
Designers. Currently he is Senior Research 
Fellow at Teesside Polytechnic working on 
image processing linked to expert systems 
and neural networks. 


You typists may obtain this code in ma- 
chine readable form, plus that from Dr 
Webster's previous articles, by sending in a 
disk as per the rules laid out on Page 3, 
column 1, Please mark your envelopes ‘TIFF’. 


@ *.DBF; map data, 
Places, & enhancement 
@ *.PRG; draw, zoom, 
manipulate etc the maps 
using dGE v2.1 or later 
B *.EXE; build structured 
maps, add places, etc 
@ Requires VGA colour 
screen & 4MB space 


— Front End Access 
maps with guidance 

@ Structured and free 
zoon 

B® User designed maps 

M@ Tactical mapping with 
multiple overlays 

M Modelling and ‘What If! 
scenarios 

M Real time simulations 

@ Presentation graphics 


EC folio 


@ Structured Levels 0-3 
@ Link to EUROSTATS 
and national statistics 
B Common reference 
Latitude & Longitude 


dilaps 
£225 


plus YAT in UK> 


WONKDUAGDHE 
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Marketing 


Rate of Change 


Spatial Menu 
.Beeston 
-Bruxelles 
-Frankfurt 
-Koln 

. London 
.Munchen 
.Potsdam 
Stuttgart 
-Worcester 


Gazetteer 
Places & Zones 


Traffic 


Market Share Repor. 


° 
Area & Spot 
Comparisons 


Nap Graphic Profiles 
using industry standard software & hardware 
to help you create a new relationship with your data 


dMaps from INN DATA LTD 


PO Box 372, Wimbledon, 


London SH19 6LH 


Tel (+44) 681-784 2695 
Screen Control & Graphs by dGE from Bits per Second 


“> CIRCLE NO. 392 ||. 


Do you find you’re being engulfed by trying to 
manage change, but think that using a 
configuration management tool would be an 
even bigger headache? It doesn’t have to be 
that way. There is a system which can make all 
of this manageable. Configuration management 
tools from  Intasoft provide effective, easily 
implemented solutions across a _ range of 
platforms which will improve your productivity, 
reliability and quality. 


Available for: MS-DOS, Unix, VMS, OS/2, OS-9 


4h : 


[= 
ae 


| ..{here’s a light at the end of the tunnel 


Intasoft’s Software Management System (SMS) 
provides a complete, integrated suite of tools 
that takes the hard work out of managing 
change. The tools included cover version control, 
configuration management and building, and 
modification request management. 


See the light! Call for further details. 


MS-DOS Prices: 1 User £490, 5 Users £980 


Quality tools for professional software developers from JNesot [ 


Tresco House 153 Sweetbrier Lane Exeter EX1 3DG Tel: 0392 217670 Fax: 0392 437877 


> CIRCLE NO. 393 
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OOPLs for Windows 


A Choice of Weapons 


There are many object-oriented development environments which make a 
Windows programmer's life much easier. Thomas Payne compares two 
of the most established tools, Actor and Smalltalk V. 


When it comes to programming for Win- 
dows, there is no doubt that object-oriented 
(OO) techniques are the best way forward. 
OO techniques give a quick turn-round in 
producing Windows applications for the 
market-place, whether that is internal or 
external to your organisation. For C pro- 
grammers the way forward is usually to start 
using C++. However, there are other object 
oriented development environments which 
offer greater productivity than C++ and can 
produce very sophisticated and complex ap- 
plications as well as being ideal for develo- 
ping your application prototypes. 


Two of the most popular object-oriented 
development environments for Windows 
are Actor and Smalltalk. Both of these pro- 
vide an integrated environment which 
allow you to have your application running 
while changing the underlying code within 
the application - without having to go 
through the edit-compile-run cycle typical 
of most third generation languages. 


Smalltalk V for Windows is one of Digitalk’s 
family of Smalltalk V products which covers 
the DOS, Windows, Presentation Manager 
and Apple Macintosh environments. Digi- 
talk started its product range with the spe- 


cific aim of providing a practical version of 
Smalltalk, designed to run on PC platforms. 


Actor was developed early in the life of 
Windows by the Whitewater Group (now 
owned by Symantec), infamous for the 
Whitewater Resource Toolkit. Only in Win- 
dows 3, with its comparative lack of mem- 
ory constraints, did Actor fulfil its potential. 
It was designed to be faster and more com- 
pact than Smalltalk, while offering the same 
level of functionality. Actor 4, released in 
November 91, had some new features 
which make it easier to trap events and 
prototype Windows and includes support 
for SQL databases, Microsoft's help system 
and multiple inheritance. 


Serious Applications 


It is a common assumption that these tools 
are good for developing smaller applica- 
tions quickly, but are not so good for larger 
projects. Our experience at ISA contradicts 
this. The Predictive Insurance Sales Force 
Model (PRISM) built for Tillinghast (Figure 
1), was mainly developed in Actor, with 
some C modules which performed the 
computationally intensive vector manipu- 
lation which was necessary. 


“Define Configure fun Analysis Sur 


Options Windows 


Project Gla 
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ett Productive Branche: 


=] Value of Sules Summary - Adjusted Value of Sales x 


Project ID: 
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testing3 


Create a 


reve 
Instance Modal 


6 Dictiong File Edit Draw 
Initances 


Information Systems Ass 


Current Project: Object Hierarchy for Eve 


Dpen an estat 
Instarice Nod 


Fadil Draw Remove” View Options 
Create report] Needs a desenption 


Figure 2 shows the Eve CASE tool (used by 
ISA, to support the OMT method for object- 
oriented design and analysis). Eve was writ- 
ten using Smalltalk V for Windows. This 
application communicates to a SQLBase 
database through a DLL and enables full 
documentation for object-oriented systems 
to be gathered. It can read Smalltalk and 
Actor files to produce documentation for 
those systems automatically, with support 
planned for C++, 


Actor and Smalltalk do provide good proto- 
typing. But our experience of Actor and 
Smalltalk agrees with that of several large 
multinational companies that high-level 
00 tools are suitable for complex and im- 
portant applications. 


Installation and Setup 


Smalltalk comes on a single floppy disk. 
When installed (using a Windows-based 
program) it uses just over 2.5 MB of disk 
space, including all of its example files. 
Most of Smalltalk is contained in several 
large DLLs, split into those which support 
the development environment and those 
which are base classes, used both in devel- 
opment and run-time applications, Small- 


ve View Options 


in) iilauee Sao 


Eve Complete Hieron 
= ay 


Suniinais fat 0 


“eens 


Year 


Figure 1 - PRISM, written in Actor 
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Figure 2 - The Eve CASE tool, written in Smalltalk V 
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Hardlock E-Y-E°- tying the hands 
of software pirates 


The effective way to protect your software 
FAST Electronic has made life a lot harder for soft- 
ware pirates. Hardlock E-Y-E was designed using 
cryptographic principles. It took the experience 
and know-how of Germany’s number one in soft- 
ware protection and the leading edge technology 
of a US semiconductor company to create the 
ultimate software protection tool. 


The technology programmers have at their 
fingertips 

Hardlock E-Y-E is based on a custom chip and 
combines all the features that a programmer 
would expect from such a device: secure, algo- 
rithmic query routines and an optional non-vola- 
tile memory for custom configurations. With the 
Crypto-Programmer card from FAST you can pro- 
gram the algorithmic parameters and the memory 
within seconds. This unique card guarantees that 
no one else can burn Hardlock E-Y-Es with your 
codes. Linking Hardlock E-Y-E to your software is 
easy: you can either protect your.COM and .EXE 
files with the automatic encryption software 
HL-Crypt or integrate FAST’s high level language 
routines into your source code. 


Order your demo unit today. Contact Magnifeye, 
235-239 Walmer Road, Walmer Studio # 6, W 11 4 EY, 
Telephone 071 221 8024, Fax 071792 3449. 


Readily acceptable to your customers 

Hardlock E-Y-E allows unlimited backup copies 

of the master floppy. The customer gets the device 
together with the software and plugs it into the 
parallel port between the printer and the PC. Daisy- 
chainability, outstanding reliability and the compact 
high tech design guarantee that your customers 
will accept Hardlock E-Y-E. 


The benefits your management will appreciate 
Hardlock E-Y-E can be programmed by the soft- 
ware house 
with the 
Crypto-Pro- 
grammer card. 
This ensures 
optimum deli- 
very schedules 
and stock flexi- 
bility. Revenues 


will go up as 

software piracy 

and multiple Hardlock E-V-E 

usage are programmable, algorithmic response 
prevented. and memory option - all in one 


MMAGNIF @ 


Magnifeye is a subsiduary of Fast Electronic GmbH. 


ROGRAMMER’S TOOL 


QBS Software Limited specialise in providing and supporting the best add-on libraries and utilities for 
developers throughout Europe. We stock a range of libraries, utilities and now books. We will also source 
software that is not currently on our product list. For information on products please contact our technical 
support team by phone, fax or via our bulletin board. 


We publish a quarterly news booklet, QBS Software News, which is sent free to all registered users. It is 
packed with product information, news on new releases, bug fixes and articles by renowned gurus and authors. 


CLIPPER & FOX LIBRARIES 


BabelFish 

Bar Code Library (for 
Clipper and C) 
Clipper Tech. Guides 
CLGraph 

CLReport 

CLShield 

CL Text 

CLTools 

CLWindow 

Clipwks 

dbXstore Il 


dGE Version 4 
Dr Switch ASE 
Escape 

Fast Text Search 
Flextile 

FUNCky Il 


Getit 
GFORCE 


Grumptish Library 
Grumptish Menu 
Grumptish Reporter 
IQUERY 

The Compiler Kit 
Mouse Driver 
Nantucket Tools II 
Netlib 

Novlib 

Overlay0 

PegLib 
ProVision:Windows 
Scripton 


SilverClip 


Drive Pradox files from Clipper 

Produces most bar codes. Supports Epson, 
HP, Postscript printers 

Books from Rick Spence and Phil Schwartz 
Graphics Library 

Linkable report generator 

Data protection, encryption and integrity 
Linkable word-processor 

General function Library 

Wiridowing Interface Library 

ReadMrite Lotus/Quattro Pro 


Stores text, objects, array and Gforce 
graphics screens. 
The business graphics library 


Create RAM resident applications 

HP Printer control library 

Advanced Text Search Technology 
Variable length fields and .DBT replacer 
Function Library with over 1000 functions 
includes Notepad Class 

Events library and GET system enhancer 
Fast graphical interface Library with Screen 
Editor/Graphical TBROWSE 

Friendly Function Library 

Smart Menu Systems 

Linkable Report Generator 

Indexing function library 

Convert dBASE IV apps to run in Clipper 5 
From Chydale Software 

General purpose function library 

Novel and Netbios Networking Library 
Novel specific Networking library 
Memory Roll Out Library 

Linkable Pegasus read/post functions 
Text based event driven interface library 


Comprehensive PostScript Library available 
for Clipper and C 
Professional Comms (Includes full source) 


SilverComm 


SilverFox 
SilverPaint 
SOS Help! 

SubNTX 

Six Driver 

The Engine 


Communications Library with full 
control of serial devices 
Communications Library for FoxPro II 
Graphics Library for Clipper/FoxPro II 
On-Line Help System Development 
Fast Filtering Utility 

SuccessWare Index Driver 

Linkable Spell Checker 


GENERAL UTILITIES 


9K 
Blinker 


Ed for Dos 

Ed for Windows 
Embark 

Expert Help 

R & R Report Writer 


R&R Code Generator 
SpellCode 
ZipitUp 


xBase Version Control Without Tears 
The Dynamic Overlay Linker. For C, 
C++, ASM, Pascal, Fortran, Clipper. 
The Programmer's Editor 

The New Windows Version 
Installation and Management 

Drop-in replacement for Norton Guides 
Relational Report Writer for Clipper, 
FoxPro, dBase and Paradox 

Create programs from R & R reports 
Jake Geller's Spell Checker 
Software Protection System 


CLIENT SERVER 


Biton 
ClipSQL 
ExtendBase 
RaSQL/B 
RaSQL/x 
SQLBase 


Oracle Library (For FoxPro & Clipper) 
SQL Server/Sybase 

Client Server with .DBF files 

Access Btrieve files 

For Novell Netware 386 

Access Gupta SQLBase 


CLIPPER OOPS 


BaseClass 
Class(y) 
ClassMates 
dbXstore 
StarClass 
SuperClass Ill 
Viewlt 


All trademarks recognised 


90 days free technical support by phone or fax. 30 day money back guarantee 
(on selected products) 


Clipper 5 Object Library from Chydale 
Create new Clipper Objects 

Class library with source 

Save SuperClass Objects 

User Interface Class(y) Library 
Design your own classes 

User Interface Class Library 


For further information, free demo software, prices and how to order please contact: 


QBS Software Limited, 10 Barley Mow Passage, London W4 4PH 


Tel: +44 81-994 4842 Fax: 44 81-994 3441 


BBS: 


+44 81-747 1979 
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ADVANCED BUSINESS GRAPHICS 


ADVANCED BUSINESS GRAPHICS 


talk V's development environment uses ap- 
prox 1.5 MB of Windows memory; applica- 
tions use upwards of about 1 MB, 


Actor also has a Windows installation rou- 
tine, which gives you the choice of how 
much to copy across. Installing the whole 
lot requires about 8 MB of disk space, al- 
though the core Actor system including the 
Object Windows Library (OWL) will only 
take up 2.5MB of disk space. Actor only 
needs two files to run, ACTOR.EXE and the 
image file ACTOR.IMA (the other files are 
all part of the development environment). 


Smalltalk¥ Transerip 


The Actor program is much smaller than 
Smalltalk with all its DLLs and thus uses a 
minimum of 500 KB depending upon the 
static and dynamic memory settings you 
use (see memory management). This 
means Actor can run on a 286 with 2 MB of 
RAM, whereas Smalltalk needs a much 
more powerful machine. 


Ease of learning 


The syntax for both languages is fairly simple, 
partly because everything in both systems 
is an object. The main learning curve asso- 


Fred ci 


Fred = TextWindow windowlabeled: ‘Hello World’ 
frame: (100 @ 250 comer: (450 @ 450)) 


Fred nextPulAll ‘This is a string which will be displayed on the window’ 


e Edit’ Smalltalk 


Hello World — 


Second sting on window 


Thiid Sting much lower 


FSrnaltalk/Y Class Hierarchy Browseritled) 


This is a sting which will be displayed on the window 


Figure 3 - Creating a text editor in the Smalltalk workspace 


ere 


i sans 
Actor Display 


a 


Actor Display 


Cleanup: 


Fred := new(FileWindow) 5 
create(Fred) 5 


newline(Fred); 
newline (Fred); 


newLine(Fred) 5 
newLine(Fred) 5 


The Second String 


paienaly 


Figure 4 - Cr ating a 


printString(Fred, “Here is the first String"); 


printString(Fred, “the Second String"); 


printString(Fred,"“Third string after some space"); 


third string after some space 


Sing 


poe 


OOPLs for Windows 


ciated with both environments is learning 
the class hierarchies upon which they have 
been built and the methods belonging to 
those classes. Once these have been mas- 
tered, Windows applications can be gener- 
ated extremely quickly within each of the 
environments. The code shown in Figures 
3. and 4 creates a simple editor comparable to 
Windows Notepad, without the limitation on 
file size, In both cases, it only takes one ortwo 
lines of code to create these editors. 


For people not used to the idea of OO pro- 
gramming, Smalltalk’s syntax can look a bit 
odd. The code example in Figure 3 creates an 
editor and adds some initial text. In the first 
line we create and show a window, by sending 
the message windowLabeled: ’ xxx’ 
frame: aRectangle and assign it to the 
global variable F red, The following lines add 
text to this window. The syntax is very simple, 
as absolutely everything in Smalltalk is an 
object to which messages get sent. Even con- 
trol constructs, such as looping statements, if 
statements and iteration, are implemented as 
methods within Smalltalk. All you need to 
know is where to put full stops and commas in 
your code, Iteration, or looping over an array, 
collection (list), dictionary or string, is per- 
formed with ‘do’ messages. It is difficult to 
appreciate how useful these messages are until 
you have actually used them. 


Actor’s syntax is a cross between Pascal and 
C, Messages are sent to objects in a similar 
way to function calls in C, where the first 
argument in the list is the receiving object. 
The equivalent code used to create a simple 
text editor with some initial text is shown in 
Figure 4. Actor has its control constructs 
within its syntax such as if /else, select (for 
case statements) and one looping con- 
struct. However, iteration over arrays and 
collections is programmed by sending the 
‘do’ message to an object in the same way 
as Smalltalk. The syntax within Actor has 
been deliberately designed to be familiar to 
3GL programmers, 


Development environments 


Code within Smalltalk and Actor is written 
in a browser. Class browsers list all the 
classes, in a hierarchical fashion, and all of 
the methods and variables associated to 
those classes. Methods are compiled indi- 
vidually and added to the image (your cur- 
rently compiled code). Browsers allow you 
to compile your code incrementally and 
also let you see, and more importantly 
change, all the code that has been written 
to develop the programming environment 
and the system’s base classes. Within the 
browsers you can find many a short-cut for 
developing your applications - the brow- 
sers are often more informative than the 
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documentation. The way browsers are 
used in both languages strongly supports 
the concept of code reuse. 


An important feature of both Actor and 
Smalltalk is their ‘work windows’. You can 
type directly into these to test code frag- 
ments or run your application within the 
development environment. This is a very 
useful way to test how objects work, both 
those within the system and those which 
you are creating yourself. For people not 
familiar with the Windows SDK’ (hands up 
those who can recall all 600 calls from mem- 
ory), this is a great boon, especially in Actor 
where the brave can type an SDK call at the 
work window and immediately see its ef- 
fect. An important feature of fully interac- 
tive environments is that much more of 
your time is spent programming rather than 
compiling. When switching from Actor or 
Smalltalk to C or C++, I find it very frustrat- 
ing having to compile an application just to 
test out small code fragments. 


Also integrated within your environment 
are debuggers and inspectors. The de- 
buggers appear either when an error occurs 
or when you insert a break in your code. 
They allow you to browse the current ex- 
ecution stack and look at the state of any of 
the objects and their instance variables. In- 
spectors are used for looking at the objects 
and their instance variables. You can 
change the value of an instance variable, if 
needed, before resuming execution of your 
program. The debugger not only allows 
you to see the current methods being ex- 
ecuted but also enables you to change 
those methods on the fly. This makes the 
programmer’s life much easier. 


Although Smalltalk and Actor both have 
debuggers, the Smalltalk debugger allows 
you to step through execution of the code 
and thus enables the errors to be tracked 


Smalltalk V Class Hierarchy Browser 


File Edit Smalltalk Classes Variables 


Methods 


down more easily than within the Actor's 
debugger. 


Memory Management 


One of the greatest advantages with both 
Smalltalk and Actor is their automatic mem- 
ory management facilities. Both have dy- 
namic garbage collection, which means the 
programmer does not have to worry about 
allocating and freeing memory fated 
to the objects in the system. This can save 
a huge amount of time, both during devel- 
opment and later in the life cycle, as auto- 
matic memory management removes a 
major opportunity for human fallibility. As 
anyone who has programmed Windows 
will know, one of the largest problems is 
making sure that all the memory used is 
freed up before being discarded. 


One potentially limiting aspect of pro- 
gramming in Actor is the limit in the num- 
ber of object pointers. If large arrays of 
objects are being used then the limit is 
easily reached. This gives rise to various 
fixes within Actor which generally make 
it less object-oriented, forcing the pro- 
grammer to create objects which have 
specific types associated with them so 
that object pointers can be saved. Small- 
talk has no such limitations and will use 
all the memory available. 


Both languages use a system of ‘ephemeral’ 
garbage collection (which roughly trans- 
lated means it should not get in the way of 
your program running), achieved by keep- 
ing a count of all references to an object. 
When the count becomes zero, the object 
cannot be referenced, so its allocated mem- 
ory is automatically reclaimed. Actor splits 
its memory into two, static and dynamic. 
Static memory is not garbage collected, and 
is used for permanent objects like classes 
and method code. Dynamic memory is 
into halves 


[=1+1 cessible obje 


ProcessScheduler 
Rectangle 
Semaphore 

Stream 
ReadStream 
WriteStream 

ReadWriteStream 
Ht scale 


“Answer a new Point which is the receiver Point 
divided by scale. Scale can be a number ora 


Point. If scale is a Point the x-coordinates 


are divided and the y-coordinates are divided." 


scale class == Point 
iffrue: [" (x # scale x} @ (y # scale y)] 
iffalse: [* [x H scale) @ (y # scale] 


swapped between 
the two halves until 
one part of memory 
contains de-refer- 
enced objects. This 
memory is the re- 
claimed in one go, 
making garbage col- 
lection very fast - at 
the expense of more 
memory. 


Performance 


Traditionally the 


Figure 5 - Smalltalk’s Class Browser 
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sheer novelty of 
high-level OO tools 
thas been enough to 
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scare off many ‘serious’ developers. Now 
that these ‘novel’ concepts have been 
adopted by respectable vendors this is less 
the case, but two big concerns still remain 
- speed and size. If size of executable and 
all round performance are more important 
to you than development and maintenance 
costs, then you should stay with 3GLs. But 
if you have even a little leeway, Actor and 
Smalltalk become viable. They both out- 
perform 4GL tools like Omnis and Visual 
Basic. 


Both Actor and Smalltalk can be slow in 
operation, though this tends to be due to 
disk swapping on low-end machines. 
When running on machines with enough 
RAM (such asa 386 with 4 MB and Windows 
swap file) then the operation of applica- 
tions can be comparable to those written 
with 3GLs. As always, if part of a system has 
been programmed badly, there can be per- 
formance problems - but this is not unique 
to object-oriented programming. 


Object Draw, a demonstration application 
which is delivered with Object Graphics for 
Actor and for Borland C++, seems to work 
just as fast in both languages. Draw written 
in C++ is 408 KB; written in Actor it has a 
150 KB .EXE and 470 KB image. 


But it is true that Actor and Smalltalk (espe- 
cially the latter) can both be quite slow when 
loading and unloading from memory. In large 
systems, we have also found that the compu- 
tationally intensive parts of a program can run 
slowly. However, as these parts can be rewrit- 
ten as a DLL in a lower level language, there 
are generally no problems with the final ap- 
plications. User interface code within these 
systems performs acceptably. 


Many Windows programmers have used 
an Actor program: the Whitewater Re- 
source Toolkit (originally bundled with 
Turbo Pascal for Windows). The slow 
speed of this product was due to its work- 
ing within Windows 2 memory restrictions 
and a more recent version is over three 
times faster. However, this is a good 
example of software which, if just five per 
cent had been written in C, would be in- 
distinguishable in performance froma tool 
written completely in C or C++. 


Class Libraries 


One of the most important aspects you 
need to look at when choosing an object- 
oriented tool will be the class libraries 
available. There are many third party 
class libraries available for Actor and 
Smalltalk, either purchasable from vari- 
ous suppliers or downloaded from bul- 
letin boards. 


printessyimproveyoursoware IK, VERSION CONTROL 
Series vir alesicaprse WITHOUT TEARS 


a complete system, at any time. 
=== Control source, object, a wr, 
binary, dBase files and documents. | . > 

=== Recover code from uninten- " , 
tional changes. 

m= Quickly locate bugs introduc- 
ed during software development. 
=== Retrieve any prior version, or 
release of your software system. 
=== Highlight the revisions to 
ASCII & dBase format files and 
comment those changes with 9k’s 
Unique Split Screen Differential 
Analyser. 

@ Optional File 
Compression 

@ Unlimited Multiple 
branching tig ee 
@ Menu or a command 
line interface with on- 
screen help 

@ Full reporting and 
more... 


At last! A Version Control System 


that fits in with the way you work —_ Especially recommended for xBase Forte sotiwate Foals tte és sortwate rey 

a is aj a! developers lunsdon House, Waltord, jarley Mow Passage, 
lisa peysto oe P Ross-on-Wye HR9 5SB. London W4 4PH. 

@ 9k costs just £149.00 To place an order, request a demo Tel/Fax: 0989 767656, or: Tel: 081-994 4842 

@ 30 day money back guarantee disk or for further information call: Fax: 081-994 3441 


bbs: 081-747 1979 
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We led the way with dGE. This is the other 
indispensable library for Clipper. For the 
first time your Clipper programs can have 
the look and feel of a Windows application. 


Visual interface has it all... 
Multiple windows that can be moved, sized, 
maximized and minimized 
A complete range of interactive controls 
An integrated event handler 
Simple to program 
Fully object-orientated 
Runs dGE graphics in it's windows 
Your applications will never be the 
same.... 
Create graphical dialog boxes, data-entry 
forms and context-sensitive help screens 
Select files from scrolling list boxes 
Import .bit-mapped images 
Create queries using icons, radio buttons, and 
check boxes aaa 
Run several windows concurrently and move Price: £245.00 
between them with a keystroke or mouse-click From: Bits Per Second Limited 


VI comes with a 250 page manual 14 Regent Hill, Brighton, E.Sussex BN1 3ED 
including over 100 pages of tutorial with Tel. 0273 727119 = Fax 0273 731925 


examples. Requires: Clipper 5.01 The VI library contains elements of Class(y) and SuperClass issued under licence. You do not 
DOS 3.x or higher need to buy these products to use VI with Clipper 6.01 
Classly) (c) Anton van Straaten 
640K RAM SuperClass (c) Chydale Software 
EGA or VGA dGE, Visual Interface (c) Bits Per Second Ltd. 


> CIRCLE NO. 397 


Actor comes with a comprehensive set of 
class libraries with its distribution. Its Win- 
dows class library is based on Object Win- 
dows Library (OWL) - as supplied with 
Borland’s C++ - which should enable you 
to move your applications from Actor to 
C++ if necessary. Supplied with Actor is 
Object Graphics, a class library which en- 
capsulates the Windows GDI, and a class 
library for interfacing to SQL databases. This 
currently uses Pioneer’s Q+E DLL, enabling 
xBASE applications to be built simply with- 
in Actor. Each of these class libraries comes 
with its own documentation. 


Smalltalk does not come with any major ‘add- 
on’ class libraries. However there are many 
third party class libraries available. Of note is 
WindowBuilder which adds a Visual Basic 
style interface onto Smalltalk allowing win- 
dows to be built graphically, with the events 
being programmed for the objects placed on 
the screen. WindowBuilder can also be ex- 
tended easily to add control classes which 
you have developed as wellas the core Small- 
talk classes. There is also a SQL set of classes 
which uses the Techgnosis SequelLink pro- 
duct, allowing interfaces to many different 
back end databases. One of the best class 
libraries is the Envy/Developer product 
which helps manage multiple developer pro- 


jects and manages the version control for 
the application. This is a particularly im- 
portant product, because neither Actor or 
Smalltalk projects are easy to manage with 
more than two or three programmers. 


Conclusion 


Both Actor and Smalltalk will enable you to 
develop complex Windows applications 
more quickly than using a 3GL, such as C, 
Pascal or C++. Because you can make direct 
calls to the API, they do notlose any Windows 
functionality - as is the case with many restric- 
tive 4GLs. 4GL tools will always remain the 
best solution for the types of application for 
which they have been developed, unless the 
functionality needs extending. 


The main differences between Smalltalk 
and Actor are the ways in which the class 
ibraries work. Both are extremely pro- 
ductive and enable quick development of 
Windows applications. Actor currently 
has better class libraries and produces 
smaller executables and images than 
Smalltalk, although Smalltalk produces 
much more portable code if you are in- 
tending to develop for other platforms. 
There is more third-party support for 
Smalltalk. 


OOPLs for Windows 


At the end of the day, choice of develop- 
ment tool is dependent upon the type of 
application you want to build. If all my 
Windows applications were straightfor- 
ward database front ends, I would pick a 
respectable 4GL tool. For small to medium 
general-purpose systems - say a small ap- 
plication which need whizzy graphics and 
stored data in dBase files - 1 would choose 
to use Actor, especially if the application 
needs to run on relatively low-end ma- 
chines. If the system was much larger, 
needing multiple programmers and hand- 
ling large amounts of data, I would use 
malltalk. And for low-level register access, 
memory control, tight executables and high 
speed, I still need C and C++. 


n 


EXE. 


Thomas Payne works for Information Sys- 
tems Associates (081 993 8080) and has 
programmed Windows application with 
Actor, Smalltalk and C++. 


Actor bas an RRP of £179 for the plain 
vanilla version, or £349 for ‘Actor Profes- 
sional’ described here - contact a dealer for 
information. Smalltalk V for Windows costs 
£330 from Cocking and Drury (071 436 
9481). 


Not available in ANY other Key product. 


*EVERLOCK - 


Option? 


- EVERTRAK 


Option? 
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SINGLE WIRE ZERO LOAD - Total Compatibility. 


The Soft ware 
Software-Only Copy Protection; economical & SECURE. 


wx Non Copy-Protection 


Non Copy-Protection - Anti Hacker software protection. 


CALL FOR A FREE WORKING DEMO DISKETTE 


Other Services include:- Disk Duplication & 
supply - Label Production & supply - Packaging. 
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MicroSystems 
22A, Bartleet Road, 


Washford Industrial Estate, 
Redditch, Worcestershire, 
B98 ODG. England. 
Tel: 0527 510 105 
Fax: 0527 514 229 
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“PowerBuilder was the only graphical application 


builder we saw—and we.saw them all—that was 
powerful enough to build the kind of client/sery- 


er application we needed for our records-intensive 


retail auto-leasing program. In a mainframe envi- 


ronment, it would have taken almost a year—and 


a lot more resources—to develop even a non- 


GUI database application that was this powerful. 


But with PowerBuilder we did it in just four 


months—training time included. The power is 
Sogs there, because the DataWindows feature really 
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C ——) PB hetive encore 


tands the database. And PowerBuilder is so 


fast and easy to use, we feel we can get our next 
OBitting 


Fl 
release out the door in six weeks.” 
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[Amecwerss | oot ie Cop Lease ech, A Ralph Viscomi 
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Powersoft. 


THE POWER Is YOURS 


i orary 
¢: Creating temp ; 
swap file, please wait. 


How much longer can you afford to wait? 


Create Overlaid Programs-Fast. 
BLINKER", the world's first and 
fastest dynamic overlay linker, 
reduces your link time to seconds 
and reduces program memory 
requirements. Now you can use 
one linker for all your software 
projects. 


One Linker, Many Languages. 
BLINKER 2.0 links and automati- 
cally overlays DOS programs 
written in Microsoft?C, BASIC, 
Assembler, QuickBASIC”, 
Fortran, Pascal, Watcom” C, 
Zortech C++, Clipper, FORCE® 
and in Borland’ C, C++, 
Assembler, and more. 


Save Time and Memory. 
BLINKER removes the need for 
overlay structures, simplifies 
program design and reduces 
memory requirements to save 
you time, effort and memory. 


Memory Swap Function. 
BLINKER is the ONLY linker, to 
offer an integrated memory swap 
function, so you can run other 
large programs from within your 
program, with negligible memory 
overhead. 


=| 
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High Performance Qynarnic Overlay Linker 


Don't Settle for Less. 


Other major features include full 
CodeView’® support, use of 
EMS/XMS at program run-time, 
and enhanced execution speed 
of overlaid code. 


Time is Money. 

BLINKER offers all this in a frac- 
tion of the time it takes to link 
with your current overlay linker. 
You know time is money, and link 
time is no exception. 

To try our free demo re | 
on your own code a 

and for more information 

contact our U.K. distributor: 
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UK. 
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UNIX Terminal Interface 


termio blues 


Richard Samworth ignores all the warnings, 
climbs inside UNIX and tinkers with the async drivers. 


The UNIX community has it’s fair share of 
bores - bearded folk with beer bellies and 
T-shirts who look like parodies of Bjarne 
Stroustrup. You know, the sort of people who 
wear fawn coloured socks under open-toed 
sandals. (What wrong with this? - Ed.) 


They have developed and enforced an ela- 
borate series of rules and regulations regard- 
ing what you can and can’t do in UNIX, and 
usually defend this position by saying some- 
thing like ‘Well, er Roger, I think you will find 
itaxiomatic in UNIX thatwe build on the work 
of others’, Never trust a man who uses the 
word ‘axiomatic’, or calls you Roger when 
your name is Richard, that’s what I say. 


Unfortunately, when you want to break out 
of UNIX and connect it to something else, 
there is no work of others. ‘Why on earth 
should you want to?’, the bores reply and 
turn once more to their terminals. 


Fortunately, the designers of UNIX are 
older and wiser than their bearded follo- 
wers and devised the general terminal in- 
terface (termio) which provides a 
generalised and portable set of rules for 
driving attached async devices. Unfortu- 
nately, the description of its use is, as usual, 
spread all over the documentation. 


So, tie down your system administrator and 
let’s look at DIY async communications in 
UNIX. 


change the baud rate, character framing, 
parity etc, The manuals all assume that you 
want to do this to drive a new sort of screen 
and keyboard (terminal) on your system, 
but the above holds true for async modems 
too. 


init-getty-login-shell 

UNIX was born connected by an umbili 
cal cord to a teletype and the UNIX kernel 
is usually sysgened with async terminal 
interrupt handlers. When UNIX boots, 
amongst other things, it spawns a process 
called init that reads the contents of a file 
and if one has been defined, spawns a 
specific process for each port. Normally 
init spawns the getty process and 
hands it a device file name and a mode as 
arguments, getty opens this device file 
three times and maps it to the standard 
input, output and error files. It looks up the 
mode argument in /etc/gettydefs, 
initialises the device and spawns the 
ogin process with a user name. Having 
validated a user’s name and password, 
ogin spawns the appropriate shell. 


AT&T refers to this rather wearily as the 
init-getty-login-shell sequence and has re- 
cently made some changes to it in UNIX V 
release 4. 


In order to get at the hardware directly, we 
need to stop a lot of this happening. Predict- 
ably, UNIX and XENIX do things differently, 
but the general principles are the same - you 
need to modify the file that init uses and 
stop it loading getty for the port that you are 
about to use. This, of course, breaches UNIX 
security and you are not supposed to do it. I 
hope that you used strong rope to restrain 
your system administrator. 


Nobbling getty 


Under UNIX, the init process reads a file 
called /etc/inittab. This file allows 
the system administrator to define a specific 
process name to be spawned on a specific 
port at boot time - it may not necessarily be 
getty. To stop init spawning this pro- 
cess, obtain superuser permissions and 
change ‘respawn’ to ‘off in that port’s entry 
in /etc/inittab. Save the modified 


Description of termio ioctl calls and commands 
The primary termio ioctl system calls have the form : 


ioctl(fildes, command, arg) 

struct termio “arg; 

The commands that use this form are : 
TCGETA 


Gets the parameters associated with a device file 
and stores them in the termio structure pointed to 


by arg. 
TCSETA Sets the parameters from the termio structure pointed 
The Teletype Drivers to by arg. The change is immediate. 
ay , 5 TCSETAW Waits for any output to flush before setting the 
This is where it all starts. The teletype drivers new parameters. This form should be used when 
are located in /dev/ttys and are called changing parameters that will affect the output. 
‘tt-ynn’, where ‘nn’ is the port number that TCSETAF Waits for the output to drain, then flushes the 


input queue and sets the new parameters. 
Three further termio ioctl system calls have the form : 
ioctl(fildes, command, arg) 
int arg; 
The commands that use this form are; 


they address, The world has moved on from 
teletypes but UNIX keeps the faith. A teletype, 
for those of you who have never seen one, 
was a cross between a typewriter and a toilet 
roll - a sort of character-oriented proto-Fax. 


TCSBRK Waits for the output to drain. If arg is 0, then 
sends a break ( zero bits for 0.25 seconds ). 
It is possible to open the driver for a specified TCXONC Start/ Stop control. If arg is 0, suspends output; 
portas a device file and read from it and write if, restarts suspended output. 
toitunder program control. The trick is to stop TCFLSH If arg is 0, flushes the input queue; if 1, flushes 


the output queue; if 2, flushes both. 


other processes doing the same. Using 
ioctl calls, you can reset the driver to 


Figure 1 - termio ioctl system calls 
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file to disk and type init —q at the shell 
prompt to get init to reread inittab 
and re-initialise the port that you are inter- 
ested in. 


XENIX was built from UNIX version 7 and 
will either spawn getty or not. It keeps 
its port list ina file called /etc/ttys. 
To stop getty loading for a port in 
XENIX, change the first character for 
that port’s entry in /devs/ttys from 
an ASCII value one to a zero. The XENIX 
specific processes enable and dis- 
able are used to do this when you are 
in multi-user mode. SCO says that this 
will change as XENIX is further merged 
with UNIX. 


Having disabled the processes on a par- 
ticular port, it is now possible to open the 
port directly and tall: to it without any- 
thing else getting in our way and gener- 
ally making a nuisance of itself with 
unreasonable demands for login names, 
passwords etc. To talk to the port, all you 
have to do is open the appropriate device 
file and write to it or read from it in the 
usual way. Note that group and owner- 
ship rules apply for opening device files. 


Using termio 


Touse termio, opena device file and use 
the ioct1 system call to interact with the 
drivers (Figure 1). The termio structure 
is defined in termio.h and should be 


included in your program. 


Most of the termio structure consists of 
bit fields. Individual bits in the fields are 
ORed to turn a function on or ANDed to 
turn it off. Multiple settings are ORed 
together. The ones complement is formed 
for bits to be ANDed off. See open- 
Port (port) inthe code that follows for 
an example. 


The new settings are enforced by using an 
ioct1 call with the command TCSETA or 
TCSETAF. It is sensible to save the initial 
termio settings and restore them at the end 
of your program. 


In its time, UNIX has obviously been con- 
nected to some ropy old terminals and the 
termio interface has to carry a lot of 
baggage - eg the number of tenths of 
seconds the system has to wait to allow 
an electromechanical device to strike a 
piece of paper. 


For the purposes of readability and brevity, I 
shall only discuss the more interesting settings 
in termio. I take my text from the SCO 
XENIX User's Guide, Miscellaneous Section, 
‘TERMIO(M). And verily the keepers of the 
UNIX were abroad, and spake unto us. 


c_iflag. If IGNBRK is set, the break 
condition (a character framing error with 
data all zeros) is ignored, that is, a character 
is not put on the input queue and therefore 


¢_iflag describes the basic terminal input control 


IGNBRK sets the port to ignore break condition. 
BRKINT signals the interrupt semaphore on receipt of a break. 
IGNPAR ignores characters with parity errors. 
PARMRK marks parity errors 

INPCK enables input parity check 

ISTRIP strips characters of the 8th bit 

INLCR maps NL to CR on input 

IGNCR ignores CR 

ICRNL maps NL to CR on input 

IUCLCG maps UPPERCASE to lowercase on input 
IXON enables XON/XOFF flow control 

IXANY enables any character to restart output 
IXOFF enables XON/XOFF flow control on input 
CTSFLOW enables CTS flow control 

RTSFLOW enables RTS flow control 


¢_oflag specifies the system treatment of output 


OPOST postprocesses output 

- OLCUC maps lowercase to UPPERCASE on output 
ONLCR maps NL to CR-NL on output 
OCRNL maps CR to NL on output 
ONOCR no CR output at column 0 
ONLRET . NL perform CR function 
OFILL uses fill characters for delay 
OFDEL fills in DEL else NULL 
NLDLY selects newline delays 
CRDLY selects carriage return delays 

| TABDLY selects horizontal tab delays 
TAB3 expands tabs to spaces 
BSDLY selects backspace delay 
VTDLY selects vertical tab delays 
FFDLY selects form feed delays 


Figure 2 - The c_iflag and c_oflag fields 


52 EXE Magazine, Vol 7, Issue 5, October 1992 


: Figure 3 - The c_cflag field 


is not available for any process to read. If 
BRKINT is set the break condition will 
generate an interrupt signal and flush both 
the input and output queues. 


PARMRK marks parity errors. If PARMRK 
is set, any characters received with parity 
errors are inserted into the input queue as 
a three character sequence; \xFF, \x0, 
\xX, where ‘X’ is the value of the character 
received. To avoid ambiguity, if ISTRIP 
is not set, a valid \xFF character is in- 
serted into the input queue as the two 
character sequence \xFF, \xFF. If 
PARMRK and IGNPAR are not set, char- 
acters with parity of framing errors are 
returned as NULL. 


IXON enables XON/XOFF output, flow 
control, A received XOFF character will 
suspend output until an XON character is 
received. All XON/XOFF characters are dis- 
carded. If IXANY is set, any character re- 
ceived will restart output. 


If IXOFF is set, the system will transmit 
XON characters when the input queue is 
nearly empty and XOFF characters when it 
is nearly full. 


If CTSFLOW or RTSFLOW are set, IXON 
and ITXANY can also be set so that these two 
types of flow control do not interfere with 
each other. 


c_oflag. There are no interesting bits in 
c_oflag; just make sure that OPOST is 
not set. 


Unique Toolkit Access - 100% 

access to the complete OSF/Motif > 
toolkit and all the widget properties. 

Access can be restricted to enforce 
corporate style guides and for user 
simplification. 

Unique UIM/X C Interpreter - fully > 
integrated interpreter allows 

application and behaviour code to 

be tested with the user interface in 

a variety of ways. [> | 
Uniquely Customisable - with full | 


access to its X/OPEN-compliant Hebe 


UIM/X from Visual Edge Inc, is the world’s 
favourite X Windows and Motif GUI builder. With 
over 70% world market share, UIM/X is the 
obvious choice for software engineers needing 
to create, modify, test and generate X Windows 
and Motif GUls for Unix applications. 

UIM/X goes beyond the limitations of ordinary 
GUI tools by providing a host of unique features 
and extended functionality designed for . 
professionals. 

Comprehensively the best product available, 


PIROTIEIK 


CLIENT SERVER COMPUTING 


message catalogue, UIM/X can be 
completely customised. Messages, 
labels, resource names, menus and 
editors can all be changed. 
Platform Support - available for 
most Unix workstations including 
Sun, HP, MIPS, IBM, DEC and 
Silicon Graphics. 

Protects Investment - UIM/X fully 


es afl supports industry standards. It 


< generates K&R or ANSI standard 
C, pure Motif code, and reads or 
writes UIL. 


UIM/X takes the time and complexity out of GUI 
writing, and lets you easily build X Window- 
based GUls with standardised ‘look’, ‘feel’ and 


‘behaviour’. 

Protek offers a full range of layered support “~ 
services for UIM/X, from media & manual pee NS 
updates to on-site installation, training, y, o \ 


telephone support and regular advisory visits. / o 
Clip the coupon or call us now for full details | 7 ¢** 
on UIM/X, our special Trade-in offer or 
free 30-day on-site evaluation. 


1 York Road, Maidenhead, Berkshire SL6 1SQ 78 


Tel: 0628 799555 Fax: 0628 73013 7 
ys 


RS 
> CIRCLE NO. 401 Lig 
7 


mer Z0/ 


e_cflag. The CBAUD bits (Figure 3) 
specify the Baud rate. BO is used to hang up 
the connection by dropping DTR. 


The CSIZE bits specify the character size in 
bits for both transmission and reception. This 
size does not include the parity bit, if any. If 
CSTOPBis set, 2 stop bits are used otherwise 
1 stop bit. For example, at 110 Baud, 2 stop 
bits are required. 


If PARENB is set, parity generation and de- 
tection is enabled and a parity bit is added to 
each character. If parity is enabled the PA- 
RODD flag specifies odd parity if set, other- 
wise parity is even. 


If CREAD is set, the receiver is enabled, Other- 
wise characters received will be discarded. 


If HUPCL (Hang up on clear) is set, the line 
will be disconnected when the last process 
with the line open closes it or terminates. 
That is, DTR will not be asserted. 


If CLOCAL is set, the line is assumed to be a 
direct connection with no hardware flow con- 
trol. The DTR and RTS signals are asserted but 
incoming signals are ignored. If CLOCAL is not 
set, hardware flow control is assumed. DTR 


Terminal Interface 


¢_Iflag is used by the line discipline to control terminal functions. 


ISIG enables signals 

ICANON enables canonical input processing 

XCASE enables canonical upper / lower presentation 
ECHO enables echo 

ECHOE echoes erase character as BS-SP-BS 
ECHOK echoes NL after kill character 

ECHONL echoes NL 

NOFLSH disables flush after interrupt or quit 

XCLUDE exclusive use of line 


The array c_cc[NCC] contains control characters, most UNIX implementations 


have more that the 8 listed below. 


os veo 
c_cofi 

oa va 
c_ce| 

c_ccf4] | VEOF/VMIN. 
c_ce[5] VEOL/VTIME. 
c_cc[6} Reserved 
c_co{7] VSWITCH 


DEL 
FS 
Ctrl-H 
Ctrl-U 
EOT 
NUL 
NUL 


Figure 4 - The c_Iflag field and c_cclNCC] array 


and RTS are asserted and DCD must be high 
before communications can proceed, 


LOBLK, er, the manual descends into 
heavy gobbledegook here. 


The initial hardware control value after 
open is B9600, CS8, CREAD and HUPCL. 


c_lflag. If ISIG is set (see figure 4), 
each input character is checked against the 
special control characters INTR, SWT'CH 


and QUIT. If an input character matches 
one of these control characters, the func- 
tion associated with that character is per- 
formed, If ISIG is not set, no checking is 
done. 


If ICANON is set, canonical processing is 
enabled. This enables the erase and kill edit 
functions and the assembly of input char- 
acters into lines delimited by NL, EOF and 
EOL. If ICANON is not set, read requests 
are satisfied directly from the input queue. 


/* 
Asyne Modem Driving Software 
Written by Richard Samworth 
*/ 

#include <fent1.h> 

include <stdio.h> 

finclude <signal.h> 

#include <time.h> 

include <termio.h> 

#include <sys/ioct1.h> 


#define MAXLINE 80 /* input line length */ 
extern int errno; 
static struct termio texm; 
static struct termio oldterm; 
int fd =-1;  /* device file descriptor */ 
char buf (5120); /* modemRead buffer “yf 
int bp = 0; /* NEVER checked for wy 
int hp = 0; /* overflow lg 
char commsPort {80}; | /* Comms Port name */ 
char *cpp = commsPort;/* and its pointer */ 
int debug = 0; /* Debug On/Off flag */ 
char *keywords [6]; /* Command keywords */ 
int len(6); /* Their lengths */ 
int maxkeys = 6; /* And their number */ 
int timeout = 1; /* Global timeout flag */ 
7) EEO SE OOOO aOOOO Modem Control */ 
disconnect () 
/* Wait one second, then re-set the 

modem to command mode and tell it 

to go on hook. */ 
{ 


waitSecs (1); 


7* modem to COMMAND mode */ 
write(fd, "+++", 3); 
waitFor("OK", 3); 

/* Go ON hook af 


writeModem ("ATH") ; 
waitSecs (1); 
} 


openPort (port) 

char *port; 

/* Open the comms port, then use termio 
to set Baud rate etc. Re-open the port 
on a new fd and close the old one. 
variable fd contains ~1 if this 


didn’t work. */ 
{ 

int i; 

fd = open(port, O_RDWR | O_NDELAY); 

if(fd != -1) 

{ /* Save initial settings */ 


saveMode () 


i= ioctl (fd, TCGETA, &term); 
/* Set terms and conditions */ 
term.c_cflag &= ~(CBAUD | HUPCL); 
term.c_cflag |= B9600 | HUPCL; 
term.c_iflag |= ISTRIP | IGNBRK | 
IXON | IXOFF | IXANY; 
term.c_lflag &= ~(ISIG | ICANON 
3 | ECHO); 


texm.c_cc(VMIN) = ‘\1'; 
term.c_cc(VTIME] = '\0'; 
i = ioctl (fd, TCSETAF, &texm); 
i= fd; 
/* re-open port with new conditions */ 
fd = open(port, O_RDWR | O_NDELAY); 
close (i); 
) 
) 


saveMode () 

/* Save the tty modes on entry to the 
program. Should be called before 
resorting to termio or resetMode. */ 


ioctl(fd, TCGETA, &oldterm) ; 

) 

reset Mode () 

/* Restore the terminal control settings 
to those that were in force before 
saveMode() was last called. 

ms) 


ioctl (fd, 

) 

writeModem(s) 

char *s; 

/* Write string pointed to by s to the 
Modem followed by CR. The call to 
write(S) returns the number of chars 
written, which is not necessarily 1, 
as the kernel is allowed to discard 
the character if, for instance, there 
aren’t any free clists to put it in. */ 


TCSETAF, &o0ldtexrm); 


char c, d; 
while (*s) 
{ 
if ((c=write(fd, s, 1)) != 1) 


while ((c=write(fd, s, 1)) != 1); 
sth; 


i 
write (fd, 
} 


“\r", 1); 


readModem (bptr) 


int bptr; 
/* reads the modem and returns the number 
of characters available. */ 
{ 
char c; 
int i = 0; 
while(read(fd, &¢, 1) == 1) 
{ 
c = c & 0x7£;/* AND off top bit */ 
buf [bptr++] = toupper((int)c); 
inte 
) 
buf (bptr) = '\0'; 
return (i); 


) 


ooddooondeebnneineeiinmom Bile parser +/ 


parse(s, token) 

char ‘5; 

int token; 

/* Parses the contents of string pointed 
to by s using arrays keywords and len 
for a keyword(n} of length len{n) for 
maxkeys entries. 

Returns a token */ 


char *p = 5; 

int count = 1; 

token = -1; 

while (*p) /* Convert to UPPERCASE */ 
ptt = toupper (*p) 7 


p= 5s; 
/* strip leading spaces etc */ 
while((int)*p < 65) 
ptt; 
while (count < maxkeys + 1) 
{ 
if (strnemp(p, keywords (count), 
len{count)) == 0) 
{ 
token = count; 
return (token) ; 
} 
count++; 
} 
return (token); 
i 
doIt(s, token) 
char *s; 
int token; 
7/* do whatever command we have just 


found. (Continued oh page 57) 


Figure 5 - An application using the general terminal interface 
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Sycero 
from System C. 


The best thing on the 
programmer's menu 


System C Ltd 60-61 High St Maidstone Kent ME14 1SR 
Tel 0622 691616 Fax 0622 691241 


Sycero is a powerful 4GL and applications generator 
for dBASE, Clipper or C programmers. 


Sycero is powerful enough to create even the most 
sophisticated database applications. In fact, it gives 
you the best of both worlds: the speed and ease of use 
of a 4GL with the flexibility of a 3GL. 


Sycero’s complete development environment con- 
sists of a data dictionary, screen and report painters, 
a powerful 4th generation language based on the 
dBASE/Clipper standard. It also includes automated 
program types such as menus and file maintenance, 
reducing the amount of programming needed for 
common tasks, Networking code can be automati- 
cally generated and high quality documentation is 
produced as standard. 


The multi-file report generator lets you build the 
simplest of lists or the most complex invoice, and 
automates sub-totals, pagination, report loops, user 
selection of ranges and sort sequences and wildcard 
matching. 


So, if you want to stay ahead in PC database devel- 
opment and still have time for lunch, call System C 
now on 0622 691616, or return the coupon below. 


To: System C Ltd 60-61 High St Maidstone 
Kent ME14 ISR 

Please send me further details about your Clipper 
generator, Sycero dB C] 
Please send me further details about your C 
generator, Sycero C L 
Name...... ; 
Company 
Address 


26/0b 3x3" | 


Postcode .. 


Tel 


> CIRCLE NO. 403 


dBASE is a trademark of Ashton-Tate. Clipper is a trademark of Nantucket. 


eee 


UNIX Terminal Interface 


char arg(80); 
char *a = arg, *p; 
long delay = 0; /* Secs to delay */ 
static long timer = 60; 
int code = 1; /* Return code */ 
if(getArgs(s, a) > 0) 
{ 
switch (token) 
{ 
case 1: 
sscanf(a, "%d", &delay); 
waitSecs (delay); 
break; 
case 2: 
writeModem (a) ; 
break; 
case 3: 
code = waitFor(a, timer); 
break; 
case 4: 
sscanf(a, "td", &timer); 
break; 
case 5: 
p= a} 
while (*p) 

*pt+ = tolower(*p); 
sscanf(a, "ts", cpp); 
openPort (cpp) ; 
if (fd < 0) 

code = -3; 
break; 
) 
) 
return (code) ; 
) 
getArgs(s, a) 
char *s, ta; 
/* Get the argument (s) from this 
command string. 
Return 1 if successful, -1 if end of 
string before valid delimiter, n7 
{ 
char *p = s; 
char quote = 0x22; 
int i= 1; 
/* Scan for first quote */ 
while (*p != quote) 
{ 
i++; /* Checking bounds */ 
if(i > MAXLINE - 1) 
return (1); 
ptt; 
) 
i=]; 
/* Scan for second quote */ 
while (*#+p != quote) 
{ 
itt; 
if(i > MAXLINE - 1) 
return (~1); 
‘att = *p; /* copying string s to a */ 
} 
ka = 0; 
return (1); 
) 


waitSecs (s) 
long s; 


/* Wait for s seconds, */ 

f 
long t1, t2; 
time (&t1); 
t2 = tl + 3; 
while (t2 > ti) 
time (&t1); 

} 

waitFor(s, t) 

char *s; 

long t; 

/* Reads characters from the line and 
places them in a buffer which is 
scanned for string s from position hp. 
This is, of course, case sensitive. 
Returns 1 if seen, -2 if timeout */ 


long t1, t2; 
int count; 


time (&t1) ; 
t2 = tl +t; 
while(t2 > t1) 
q 
count = readModem (bp) ; 
if (count > 0) 
( 
bp = bp + count; 
if((count = substr(s, h)) != -1) 
{ 
hp = hp + count; 
return (1); 
) 
) 
time (a1); 


timeout = -2; /* Timed out, flag it */ 
return (-2); /* and return it */ 


) 


substr(s, 1) 

char *s; 

register char *1; 

/* Checks for the presence of the string 
pointed to by s somewhere within the 
string pointed to by 1. 

Returns offset into 1 if found, 
-1 if not. / 


int length; 

char *lo = 1; 

length = strlen(s); 

while ((1 = strchr(1, *s)) != 0) 
{ 


if (strnemp(s, 1, length) == 0) 
return((1 - lo) + length); 
1l++; 
) 
return (~1); 
) 


DOSOCOCCOCC COI I OIG Application */ 


dialNum() 
/* Opens and interprets the modem 
commands file. af 
( 
FILE *in; 
char rec(MAXLINE + 1); 


char *s = rec; 
int token = -1, code = 1; 
keywords (1] = "DELAY"; 


keywords (2} = "SEND"; 

keywords [3] JALTFOR" ; 

keywords [4] = "TIMER"; 

keywords (5) = "PORT"; 

len(1] = 5; 

len(2] = 4; 

len (3) 

len[{4] 

len(5) = 4; 

if((in = fopen("commands", "xr")) == 0) 


return (-1); 
while ((fgets(s, MAXLINE, in)) > 0) 
{ 
if (debug) 
report ("$s", s); 
if((token = parse(s, token)) > 0) 
if((code = doIt(s, token)) < 0) 
return (code) ; 
} 
fclose (in); 
return (1); 
) 
main() 
{ 
int i; 
printf ("Driving Modem\n") ; 
switch (dialNum()) 
{ 
case -1: 
printf ("Modem Commands \ 
file not found\n"); 
exit (1); 
break; 
case -2: 
print£("\n*Modem Buffer \ 
Contains %s*\n", buf); 
print£ ("Modem Timeout occurred\n") ; 
exit (1); 
break; 
case -3: 
print£("Open failed, \ 
error number %d\n", errno); 
perror ("and the reason was ", errno); 
exit (1); 
break; 
default: 
printf ("Connected\n") ; 
break; 
} 
waitSecs(3); /* Wait for it */ 
i = readModem(bp); /* Clear the buffer */ 
while(i > 0) 
i = readModem(bp) ; 
bp = 0; /* Re-set the buffer pointer */ 
DR JOISTS IORI AIA ICIOR KI 
You code goes here! 
TOI IOUT ORR AIR IAAK &/ 


printf ("Disconnecting the modem\n") ; 


waitSecs(3); /* Hang about */ 
disconnect (); /* modem to command mode */ 
close(fd); /* Drop DTR, if HUPCL set */ 


resetMode(); /* Re-set the port */ 
exit (0); 


Figure 5 - An application using the general terminal interface (Continued) 


A read will not be satisfied until at least 
VMIN characters have been received or the 
timeout value VT IME has expired. 


The code 


The code in Figure 5 opens a script file 
called ‘commands’ and interprets the con- 
tents. If a line does not contain one of the 
key words DELAY, SEND, WAITFOR, 
TIMER or PORT, it is assumed to be a 
comment. The program is not case sensitive 
and I have only written the key words here 
in CAPITALS so that they STAND OUT a bit. 
Only one key word per line is processed. 
Arguments are enclosed in brackets and 
quotes, for instance DELAY ("1"). 


Predictably, the key word DELAY ("1") 
causes the program to wait for one second, 


SEND ("at.z") sends the Hayes reset string 
‘atz’ to the modem followed by a carriage 
return character, WAITFOR ("OK") causes 
the program to wait until it sees the response 
‘OK’ from the modem. WAI TFOR will wait 
indefinitely unless a time out value in seconds 
has been set using TIMER. 


The key word PORT has a special purpose 
and must be the first non-comment line. It 
causes the program to attempt to open a 
specified device file. The device file name 
must contain the full path and file name, for 
instance PORT ("/dev/tty2a") will 
open XENIX device file tt y2a which ad- 
dresses serial port COM2 on a PC. 


Using these simple commands it is possible 
to construct script files that will initialise, cial 
and perform automated logon sequences 


with any async modem. Having connected, 
Ileave it as an exercise to the reader to write 
a simple terminal emulator or anything else 
that takes his fancy. The modern among 
you will notice that I haven’t used function 
prototypes; this is because my XENIX com- 
piler doesn’t support them. Good Luck! 


(Exe) 


Richard Samworth is buying a new house 
and any extra money comes in handy. He 
is not available on any bulletin board but 
can be contacted by telephone on 0296 681 
972. 


The information in this article was based 
experiences with SCO XENIX System V Re- 
lease 2.3 and AT&T UNIX System V/386 
Release 3.2. 
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MAYHEM 


Cattullus - 
lingua novum serio 


Jules bas been looking at computer languages again. 
He thinks there are some lessons to be learned from history. 


Has it ever occurred to you how ugly 
computerspeak is? The New York accent 
may sound like traffic, and the Birming- 
ham accent may sound like metalwork- 
ing, but when two programmers or 
computer engineers get together the 
noise is enough to wilt flowers. 


It wasn’t always so bad. In the early days 
of computers we used real words, and 
where an acronym had to be used it was, 
at least, pronounceable. Now we seem to 
rely almost entirely on TLAs (three-letter 
acronyms), which only mean anything 
when written down. A conversation be- 
tween two programmers is alphabet soup. 


Apart from the fact that it is ugly, it causes 
real problems for non-English speakers. 
How is a Frenchman or a German sup- 
posed to figure out what ‘PSP’ or ‘LDT’ 
means? This whole issue of language com- 
patibility is poised to become much more 
significant when the single market ac- 
tually happens. There is a rule that every 
product sold in the EC must be marked in 
the language of the country in which it is 
sold. In French, PSP will become ‘PSL’ 
(Prefixe du Segment du Logiciel), and in 
German it will probably be only a single 
letter, ‘P’ (Programsegmentprdfix) | 


There will be a problem, though, with 
software products, Not with the manuals, 
or the user-interfaces; translating these 
can be done very simply. The problem 
comes with source codes which must be 
moved across national boundaries, or pro- 
grams written in macro languages which 
are bundled with the product. It will be 
practically impossible for a programmer 


to look at a program written by a foreign- 
er. The variable and procedure names 
will be chosen from the author's lan- 
guage. If he drops vowels the way British 
and American programmers do, it will be 
practically impossible to decode the 
names again (unless of course the pro- 
grammer is Polish; he probably wouldn’t 
bother with vowels in the first place). 


Perhaps surprisingly, this is far from a 
new problem. Long before the EC was 
evena twinkle ina bureaucrat’s eye, there 
was a problem with sharing knowledge 
and research among the intelligentsia of 
Europe. They used a language which was 
already functioning well across national 
boundaries, and was used almost exclu- 
sively for specialist knowledge. That lan- 
guage was Latin. 


The version of Latin used during the Dark 
Ages was quite different from the Latin 
with which General Agricola boasted of 
his conquests. Roman Latin was a living 
language, full of idioms, irregularities, 
and conventions. Medieval Latin was a 
much simpler language, with almost no 
irregularities, but instead a large set of 
tenses and cases, The meaning of a sen- 
tence in medieval Latin was almost inde- 
pendent of the order of the words, so it 
was far more able to represent real 
thought processes than national lan- 
guages were, but because of its orthogo- 
nality it was immediately comprehensible 
to anyone who knew even a little. 


It was this combination of startling ex- 
pressiveness and very orthogonal gram- 
mar that made it the language of choice 
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among the learned for over 1300 years. 
That most European languages were 
themselves based on corruptions of 
Roman Latin made the initial work of 
learning the language very much easier 
than it would otherwise have been. 


WU 
How is a 
Frenchman or a 
German supposed 
to figure out what 
‘PSP’ or ‘LDT’ 
means? 


UML 


Neither was it a slow-moving language. 
When mathematics from the middle east 
and chemistry from the far east swept 
away mathesis and alchemy, Latin was 
the language in which they did it. Latin 
was sufficiently expressive to absorb these 
vast paradigm shifts without any significant 
changes to the language, and it is probably 
due to the fact that Latin was functioning so 
well that the new techniques and theories 
were propagated so fast. 


I think the solution to the language prob- 
lems in the EC are staring us in the face. 
If the whole of Israel was able to start 
conducting its daily life in Hebrew, I can’t 
see why a few Euro MPs in Brussels 


shouldn't be forced to learn Latin. I also 
think we should standardise programm- 
ing terms to be in Latin. This shouldn’t be 
hard at all - programming languages 
themselves are very artificial things with 
a very restricted grammar; applying simi- 
lar conventions to user-defined names 
should involve no hardship, and if done 
consistently will improve readability 
across the new single market. 


But why limit ourselves just to user- 
defined names? Almost all synthetic lan- 
guages in common use limit themselves 
to nouns and imperative verbs. By using 
Latin as the basis of a programming lan- 
guage, one could introduce a procedure 
using an infinitive, apply it with an indi- 
cative, iterate with it using an imperative, 
terminate the iteration using an subjunc- 
tive, and so on. We could write compli- 
cated loops and conditionals in exactly 
the form we are thinking about them, 
instead of having to cast them into the 
limited forms that present compilers un- 
derstand, An entire language could be 
created based on Latin grammar, a sort of 
cross between Prolog and Frames but 
without the parentheses, It would be ad- 
mirably suited to representing knowl- 
edge, but would be capable of more than 
just the inference from facts that present 
Al languages can do - it could apply ex- 
plicitly sequenced procedures as well. 
Such a language would also be an excel- 
lent intermediate language for machine 
translation between national languages. 


What sort of control structures would such 
a language have? Again, we can refer to 
Latin literature and structure our programs 
as if they were plays. We would have an 
introduction, with a few minor players 
tidying the set, ready for the action. We 
could have minor gods and nobles per- 
forming the main action, with a chorus 
sweeping up after them and clarifying 
their actions to the audience, and finally 
a judgement from the major gods could 
perform the file loading and saving. Since 
the chorus is always present, the language 
would have multithreading built-in. 


It might work, I think I'll call it ‘Cattullus’, 


(EXE, 


Tulius libellendum est, qui linguae natu- 
ralis artificiosusque amat. facit-verbum 
suus per verbos Latinae furiabat. utervis 
per ‘tedrepov Verulamium CCI- 
VEEMMMMCLXXXV vel per CIX ad 
jules colloquerat. 


WYWAAAIEIW CAAA RY DZQARY ARARABRAIOF 


Ss 


"| ye YM, its 


SSS _ 


Cc 


.EXE Magazine, Vol 7, Issue 5, Mensis October a.u.c. MMDCCXLV 59 


60 


vu 


[WORIDAY nave sPAce POLLUTION CODEN, UNIVERSITY OF ESSEX 


© 
TUESOAY 


a DOM | i 


eget 


wr £2 


Windows sane en 


Bilingual Custom Controls 


In which our bumble explorer creates a Windows Custom Control 
recognisable by both the MS Dialog Editor and Borland Resource Workshop... 


We all know what a ‘Control’ is (?) That’s 
one of those gadgets we put in a Windows 
dialog box to either get input from the user 
or send output to the user. Edit boxes, radio 
buttons, check boxes and list boxes are all 
examples of controls. Windows includes 
several predefined controls which you can 
easily drop into a dialog using MS DlgEdit, 
Borland’s Resource Workshop, the White- 
water Resource Toolkit, or any other ‘Dia- 
log Editor’ program. 


But what if none of the predefined controls 
fit your criteria? Of course you can write the 
code necessary to implementa new control 
(which is, after all, just another kind of 
window). If you are writing in straight C, 
your work is a bit difficult, as you must 
define and register a new Windows class 
(not to be confused with C++ classes!), then 
write a WndP roc () which will handle all 
messages to be sent to your new class of 
windows. If you are using Borland’s Ob- 
jectWindows (OWL), Microsoft’s Founda- 
tion Classes (MFC), or some similar OOP 
application framework, the job is easier, as 
a new window class (the C++ type) can be 
derived from an existing one, redefining 
only those behaviours that must be differ- 
ent from the base class. 


Unfortunately, after you've finished writing 
your new control, you'll discover that you 
can’tuse itwhen designing dialog boxes with 
a dialog editor. As well as needing access to 
the control’s code (which is inconveniently in 
the application’s EXE) to display an example 
of the control and properly implement a dlia- 
log test mode, the dialog editor also needs 
information about recommended sizes and 
styles for the control, as well as a function to 


MSC7.0 
\C700\INCLUDE\CUSTCNTL.H 
\C700\MFC\DOC\TNO14.TXT. 
\C700\MFC\SAMPLES\CTRLTEST\"." 
\C700\SAMPLES\MUSCROLL\*.* 
\C700\SAMPLES\RAINBOW\".* 


BC++ 
\BORLANDC\EXAMPLES\WORKSHOPIBITBTN’.* 
\BORLANDC\DOC\CUSTCNTL.RW 


Figure 1 - Useful files for 
writing Custom Controls 
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input style data unique to this particular 
control. Because the control’s window pro- 
cedure exists in your application, you are 
stuck haplessly coding in the control’s po- 
sition and size by hand, followed by the 
incessant chatter of the disk’s stepper motor 
as you compile, test, compile, test,... 


Custom Control API 


This is where the Custom Control API 
(CCAPD comes to the rescue. It defines a 
standard for writing Dynamic Link Libraries 
(DLL) which contain not only the control’s 
class registration and window procedure, but 
also a few procedures which the dialog editor 
uses to integrate creation and modification of 
custom controls with the manipulation of 
Windows standard controls. 


In spite of the extreme utility of custom 
controls, the CCAPI is rather poorly do- 
cumented. Neither Borland nor Microsoft 
include any printed material about custom 
controls (I was looking at BC++ 3.0 & Ap- 
plication Frameworks, and MS C/C++ 7.0 
without SDK manuals). Therefore, every- 
thing I learned about the CCAPI came from 
example programs and electronic docu- 
ments included with these two compilers. 
Figure 1 shows a short bibliography of files 
where I found custom control information. 


To make matters worse, Borland considered 
the original Microsoft CCAPI specification 
inadequate (true) so it made a new CCAPI 
based on the original (good) which is incom- 
patible with Microsoft’s (BAAAAAD)). A cus- 
tom control library written according to one 
publisher’s specifications will be incom- 
patible with the other’s tools. 


To illustrate the principals of implementing a 
custom control library, I have written an 
example custom control called ‘Thermo’, 
which implements a simple thermometer simi- 
lar to those ‘percent completed’ gauges seen 
in so many installation programs these days. 
The Thermo library is written to conform to 
both Microsoft's and Borland’s CCAPIs. Ther- 
mo can be installed into, and used with, both 
MS DlgEdit and Resource Workshop. 


An Application’s View 


As far as an application is concerned, a 
custom control looks just like any standard 
control. They can be created either with a 
CONTROL statement in a dialog script, or 
by using the control’s registration class 
(‘Thermo’ in our example) ina call to Cre- 
ateWindow(). The only difference is 
that, before it can use one of the controls, 
the app must load the custom control li- 
brary into memory using LoadLi- 
brary () from the Windows API: 


HANDLE hClib = 
LoadLibrary ("THERMO.DLL") ; 


This should usually be done at the beginning 
of WinMain () or during processing of the 
WM_NCCREATE message in the app’s main 
window. It is good practice to check the 
value in hC1ib. If it is less than 32, there 
was an error and the DLL was not loaded. 


When a DLL is loaded into memory, its Lilb- 
Main () function is automatically called. A 
custom control’s LilbMain () should register 
the control’s window class to make it available 
to applications. Notice that Thermo’s Style bits 
include CS_GLOBALCLASS, making the 
class available to all apps in the system, When 
the application is finished using the control, 
it should release the DLL with the following 
statement: 

FreeLibrary (hClib) ; 

In the end, the only parts of the DLL used by 
an application are the LibMain () (to reg- 
ister the class) and the WndP roc () (to pro- 
cess messages sent to controls of the class). 
Thermo’s LibMain () and ThermoWnd- 
Proc () are shown in Figure 2. 


Thermo’s Internals 


A Thermo keeps information about itself, 
including its range, current temperature, 
and the colours to use when painting, in a 
THERMO struct stored on the local heap. A 
handle to a separate THERMO for each 
instance is saved in the first word of the 
‘extrabytes’ of the Thermo’s window struc- 
ture. A window’s THERMO is allocated dur- 
ing the WM_CREATE message, and 


ZINC 


PeGR BEFORE YOU 
| THINK ABOUT IT. | The most ineportant stage of your development cycle comes 


before you write a single line of code. You can't meet your objectives if the architecture of your 


development tools fits like a straigbtjacket. Zinc Interface Library 3.0 gives you programming 


{ms windows } 


jreedom by supporting Windows, DOS Graphics and DOS Tet more completely, and with 
more power than any other C** program tool. And Zinc does it with only one set of source 
code, That's over 85% of the PC market. But it’s only a beginning. Zinc’s flexible, single source 
solution will soon support OS/2, UNIX and the Macintosh, All without sacrificing function- 
ality, If you want C++ Programming that won't put you in a bind, call today for a free 


Zinc technical information packet and demo disk.+aa (0)81 855 9918. 


ZINC 
| INTERFACE | 
LIBRARY 
3.0 


BORLAND 


FEATURE 


Winoows 3,X 
DOS GraPHics 
DOS Text 


SINGLE-SOURCE SUPPORT FOR WINDOWS 3.X, DOS GRAPHICS AND DOS Text 


FULL Access TO WINDOWS API. 


MULTIPLE COMPILER SUPPORT (ZINC SUPPORTS BORLAND, MICROSOFT AND ZORTECH C++ IN ONE BOX) 


INTEGRATED DESIGN TOOL 


WINDOWS (PARENT, CHILD, MDI), MENUS (PULL-DOWN, POP-UP, HIERARCHICAL), BUTTONS (REGULAR, BITMAP, | 
RADIO BUTTON, CHECK BOX), GROUP BOXES, COMBO BOXES, HORIZONTAL AND VERTICAL SCROLL BARS, a a es | @ 
VERTICAL SCROLLING LISTS, STRING INPUT FIELOS | 


DATE, TIME, NUMBER AND FORMATTED STRING INPUT FIELDS, HORIZONTAL SCROLLING LIST BOXES, TOOL BARS 


LIST BOXES, COMBO BOXES AND TOOL BARS THAT CONTAIN ICONS, BUTTONS, RADIO BUTTONS, CHECK BOXES 
AND INPUT FIELDS (E.G. STRING, DATE, TIME) a 


BUILT IN DATA VALIDATION. 


NO EXTENSIONS TO C++ LANGUAGE REQUIRED 


© COPYRIGHT 1992 ZINC SOFTWARE INCORPORATED ADDRESS: 405 SOUTH 100 EAST 2NO FLOOR PLEASANT GROVE, UTAH 84062 TEL: 801.785 8900 FAX; 801.785.6996 BBS: 601.785.8997 EUROPE: ZINC SOFTWARE (UK) LIMITED 58-60 BERESFORD STREET 
LONDON, SE 18 68G +44 81 655 9918 FAX: +44 81 316 7778 ZINC, ZINC DESIGNER AND ZINC INTERFACE LIBRARY ARE TRADEMARKS OF ZINC SOFTWARE INCORPORATED. ALL OTHER TRADEMARKS ARE OWNED BY THEIR RESPECTIVE COMPANIES, 


CALL 081 855 9918 FOR YOUR FREE ZINC V3.0 DEMO DISK 


> CIRCLE NO. 404 


PC Security from Microft Technology. 
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released during WM_DESTROY. In the 
example code, I set the fields of the THER- 
MO to default values in WM_CREATE, but 
with a bit more work, you can parse these 
values from the control’s ‘text’, which can 
be found in the CREATESTRUCT pointed 
to with the message’s 1Param: 


((LPCREATESTRUCT) 1Param) -> 


lpszName 


Although small bits of window-specific in- 
formation can be stored directly in a win- 
dow’s extrabytes, larger data structures are 
easier to access if kept in a separate place, 


storing a handle to that place in the extra- 
bytes. Neophyte Windows programmers 
should note that the size of a window’s 
extrabytes is determined by the 
cbWndExtra field of the window’s 
WNDCLASS struct, and these bytes are 
read and written with the Windows API 
GetWindowWord() and SetWin- 
dowWord () functions. 


Painting a Thermo 


A Thermo’s display is quite simple - finding 
the ratio of Temp / (High - Low), it 


// thermo.c ~ Thermo Custom Control 
// Laine Stump, Sept 9, 1992 
//— RightToCopy (xr) 1992 


4 

f#include <windows.h> 

finclude <custentl.h> // MS Custom Contro. 
finclude "rwcust.h" // Borland 
Extensions 

finclude "thermo.h" 

#include "thermdlg.h" 


typedef struct 
{ // info stored for each Thermo 
int Low, High, Temp; 
LONG FColor, BColor; 
} THERMO, 
typedef THERMO * PTHERMO; 
char ThName(] = "Thermo" 
char ThVDescr(] = "Vert Thermo"; 
char ThHDescr[] Horiz Thermo’ 
char ThvStyle(] = "THS_VERTICAL' 
char ThHStyle[(] = "THS_HORTZONTAL"; 
static HANDLE hInstance; 
OID III IIIS III I IID SOI II III IIIS I 
void InvalidateAll(HWND hWnd) 
( // invalidate entire client area 
RECT x; 
GetClientRect (hWnd, &r); 
InvalidateRect (hWnd, &r, 0); 
) // InvalidateAll() 
ESOS SSSI ISIE SII SIOI ISSO III 
// ThermoWndProc() ~ processes messages 
v/s sent to a Thermo 
LONG FAR PASCAL ThermoWndProc (HWND hWnd, 
WORD wMessage, WORD wParam, LONG 1Param: 
{ 
DWORD result = 0; 
PTHERMO thd 
= (PTHERMO) GetWindowWord (hWnd, 0); 
switch( wMessage ) 


{ 
case WM_CREATE: 
// allocate & init data area 
thd = (PTHERMO) LocalAlloc (LPTR 
sizeof (THERMO) ); 
SetWindowWord (hWnd, 0, (HANDLE) thd); 
// set some values - should read 
// from control's title instead 
thd->Low = 
thd->High 
thd->Temp = 
thd->FColor 
thd->BColor = 
break; 
case WM_DESTROY: 
// free data area 
LocalFree ( (HANDLE) thd) ; 
break; 
case WM_PAINT: 
{ //very inefficient paint 
double percent; 
PAINTSTRUCT ps; 
RECT ff, bf; 
HBRUSH fb, bb; 
BeginPaint (hWnd, &ps); 
// find size of client area 
GetClientRect (hWnd, &ff); 
ff.right++; f£.bottom++; 
bf = ££; 
// determine how much of each 
percent 
= (1.0 * (thd->Temp ~ thd->Low) ) 
/ (thd->High ~ thd->Low) ; 
if (GetWindowLong (hWnd, GWL_STYLE) 
& THS_VERTICAL) 
( // vertical split 
ff£.top = bf.bottom 
= ££.bottom 
- (WORD) (££.bottom * percent); 


0x0000FF; //red 
; //black 


) 

else 
( // horizontal 
ff.right = bf.left 


= (WORD) (f£.right * percent); 
) 


bb = CreateSolidBrush (thd->BColor) ; 
fb = CreateSolidBrush (thd->FColor) ; 
FillRect (ps.hdc, &bf, bb); 
FillRect (ps.hdc, &£f, fb); 
DeleteObject (bb) ; 
DeleteObject (fb); 
EndPaint (hWnd, &ps); 
break; 
) 

case WM_ERASEBKGND: 
// swallow to avoid flicker 
break; 

// test = remove for production 

case WM_LBUTTONDOWN: 
SendMessage (hWnd, THM_RAISE, 1, 0); 
break; 

case WM_RBUTTONDOWN 
SendMessage (hWnd, THM LOWER, 1, 0) 
break; 

// Thermo APT Messages 

case THM_SETRANGE: 
thd->Low = LOWORD(1Param) ; 
thd->High = HIWORD(1Param) ; 
InvalidateAll (hWnd) ; 
break; 
se THM_GETRANGE: 


case THM_SET 
thd->Tem) 
InvalidateAll (hind) ; 
break; 
case THM_GETTEMP: 
result = thd->Temp; 
break; 
case THM_RAI 
thd->Temp += wParam; 
InvalidateAll (hWnd) ; 
break; 
case THM_LOWI 
thd->Temp -= wParam; 
Invalidateall (hWnd) ; 
break; 
default: 
result = DefWindowProc (hWnd, 
wMessage, wParam, 1Param) 
break; 
) // switch 
return result; 
} // ThermoWndProc () 
JOOS SO SOIOIOSITIOISOR ERA IIIA IIR / 
OCOSO UES SUR IOS II IOGEA AAR 7 
// DLL initialization 


4 
static WNDCLASS Class = ( 
/* Style */ CS_HREDRAW | CS_VREDRAW 


| CS_DBLCLKS | CS_GLOBALCLASS 
/* 1pfntindProc */ (WNDPROC) ThermoWndProc, 
/* cbClsExtra */ 0, 
7* cbiindExtra */ sizeof (HANDLE), 
/* hInstance */ 0, 
/* hIcon */ NULL, 
7* hCursor */ NULL, 
/* hbrBackground */ NULL, 
/* lpszMenuName */ NULL, 
/* lpszClassName */ (LPSTR)ThName 


BOSE ISSA EIEIO IIIT III 
// LibMain ~ called when DLL is loaded 
int FAR PASCAL LibMain( 

HANDLE hInst, WORD wDataSeg, 

WORD cbHeapSize, LPSTR lpszCmdLine) 

{ // Register Thermo 

Class.hInstance = hinstance = hinst; 

RegisterClass(&Class) ; 

return 1; 

) // LibMain() 


HOBOS ESSE HOI IOS ITO IOR IOI ISI 


—__—_______| 


Figure 2 - THERMO.C, LibMainO and ThermoWndProcO 
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accordingly paints part of its rectangle in 
the background colour and part in the fore- 
ground colour. Displaying this numerically 
and putting a border around the edges 
would be nice, but take up extra room in 
our limited space. Likewise, no check is 
made to eliminate redundant repaints - if 
anything changes, the entire Thermo is re- 
painted. Prudent use of Invalidate- 
Rect() and GetUpdateRect () 
could make paints much more efficient. 


An important side note here is the processing 
of WM_ERASEBKGND. We effectively swal- 
low this message, ensuring that the control 
doesn’t flicker while being repainted. 


Controlling a Thermo 


ThermoWndProc() accepts several 
commands which affect a Thermo’s dis- 
play. For example, the THM_SETTEMP 
message will set Temp to the value given 
in the message’s wParam. Since a Thermo 
will usually be in a dialog box, these mess- 
ages are best sent via SendDlgItem- 
Message (): 


SendDlgItemMessage(hDlg, 102, 
THM_SETTEMP, 25, 0); 


will set the Temp of the Thermo in dialog 
hD1lg with control ID 102 to 25. Other 
messages work similarly. 


To test Thermo, I added the WM_LBUT- 
TONDOWN and WM_RBUTTONDOWN 
messages. These just generate a 
THM_RAISE or THM LOWER message 
so that, by pressing the left or right mouse 
button repeatedly, you can watch the ther- 
mometer go up and down. You should 
remove these messages before putting 
Thermo to real use. 


Interface to MS 


For MS DlgEdit compatibility, a custom 
control DLL must have three special func- 
tions whose names aren’t important, but 
which must be exported with certain ordi- 
nal values. For Thermo, these functions 
have the names Ct LInfo (), Ct1Sty- 
leDlg(), and XlateCtl1Flags(), 
and they are exported with ordinals 2, 3 and 
4 respectively, The necessary .DEF file can 
be seen in Figure 3, while the functions 
themselves are in Figure 4. 


CtlIinfo @2 


CtlInfo() assembles and returns a 
CTLINFO structure, which contains infor- 
mation about the class's registration name, 
version and title, as well as an array of 
CTLTYPEs, which are just predefined 
styles of the same class. The struct defini- 
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tions for CTLINFO and CTLTYPE can be 
found in Windows’ CUSTCNTL.H file. Un- 
fortunately, CTLINFO only allows for a 
single class, so MS compatible DLLs can 
only have one class. You can, however, 
have different styles of the same class. For 
example, Thermo has a horizontal and a 
vertical style. With small differences in the 
data, the Ct 1 Info () function is identical 
for all custom control DLLs. 


CtlStyleDlg @3 


Ct1lStyleD1lg () brings upa dialog box 
which allows changing style and other in- 
formation for an instance of the control. 
DlgEdit calls this function when you double 
click ona control after placing it in a dialog. 
When calling, it sends a handle to a 
CTLSTYLE struct (also in CUSTCNTL.H) 
containing current information for the con- 
trol, 


ThStyleD1gProc () isused to process 
messages between the controls in the style 
dialog. Currently, Thermo’s style dialog 
only allows changing the ID number and 
title of the control, although all aspects of 
the control, including size, position, and 
style flags, are accessible through the 
CTLSTYLE. The definition of the dialog 
used is in Figure 5. 


The lpfniIdToStr and lpfnStrTold 
parameters are pointers to functions pro- 
vided by DlgEdit which convert the ID 
number between binary and string form. If 
aH file has been loaded into DlgEdit, these 
functions will recognise, and attempt to 
use, the IDs defined in the .H file. Strangely, 
lpfnStrToTd returns the binary value 
in the top word of its long return value - the 
low word is non-zero if a valid conversion 
was made. 


XlateCtlFlags @4 


The last function, XlateCt1Flags (), 
is used to convert a control's style bits into 
a text string which goes in the CONTROL 
statement. Since Thermo only uses two mu- 
tually exclusive styles, this function is rather 


simple, returning either the string 
LIBRARY ‘THERMO 
DESCRIPTION ‘A thermometer control’ 
EXETYPE WINDOWS 
CODE MOVEABLE DISCARDABLE PRELOAD 
DATA PRELOAD MOVEABLE SINGLE 
HEAPSIZE 4096 
EXPORTS 
; required for MS DLGEDIT 
Ctlinfo @2 ;Do Not Change 


CtistyleDlg  @3  ;Do Not Change 
XlateCtlFlags @4 ;Do Not Change 
;required for Resource WorkShop 


ListClasses @s 
RWCt1Info @6 
7 general 


TermoWndProc @7 
ThStyleDlgProc @8 


Figure 3 - THERMO.DEF 


64 .EXE Magazine, Vol 7, Issue 5, October 1992 


£o/ 


Windows Custom Controls 


[DODO S SOOO HESSD ISO IEEE ERI IIR / 
// MS Dialog Editor interface functions 
// (part of THERMO.C) 
ereeecerer rete eter ercectrretrcrerirg) 
void SetCtlInfo(LPCTLINFO CI, 

WORD Version, WORD CtlTypes, 

LPSTR Class, LPSTR Title) 

{ // Set the fields of a CTLINFO 

CI->wversion = Version; 

CI->wCtlTypes = CtlTypes; 

Astrepy (CI->szClass, Class); 

Astrepy (CI->szTitle, Title); 

) // Setctlinfo() 
void SetCtlType (CTLTYPE FAR *CT, 

WORD Type, WORD Width, WORD Height, 

DWORD Style, LPSTR Descr) 

(| // set the fields of a CTLTYPE 


ct->wrype = Type; 
cr->wiidth = Width; 
C?->wHeight = Height; 


cT->dwstyle = Style; 
1st repy (CT->szDescr, 
)} // SetctitType() 
ODI IOI IIIT III IR | 
// CtlInfo() = create & return a handle 
A to info structure 
HANDLE FAR PASCAL Ct1lInfo (void) 
{ 
LPCTLINFO pCl; 
HANDLE = hCI; 
//Allocate an INFO struct 
hCI=GlobalAlloc (GMEM_MOVEABLE, 
sizeof (CTLINFO)); 
if (hCI==NULL) return NULL; 
// get a pointer to it 
pCI=(LPCTLINEO) Global Lock (hCI) ; 
if (pCI==NULL) 
{ 
GlobalFree (hCI) ; 
return NULL; 
) 


Descr); 


// init data items 


SetCtlInfo(pCI, 0x100, 2, ThName, 
ThName) ; 
SetCt1lType (&pCI->Type(0}, 0, 20, 60, 


WS_CHILD | WS_VISIBLE | 
‘tTh¥Descr) ; 

SetCt 1Type (épCI->Type [1], 
WS_CHILD | WS_VISIBLE | 


‘THS_VERTICAL, 


0, 60, 20, 
‘THS_HORIZON- 


Ly 
ThHDescr) ; 
// send handle to info to DLGEDIT 
GlobalUnlock (hCI) ; 
return hCI; 
) // CtiiInfo() 
TELE LEELELLLELLLLLLT 
WORD FAR PASCAL XlateCt1Flags ( 
DWORD Flags, LPSTR Style, WORD MaxLen 
{ // convert binary Flags to string 
if (Flags & THS_HORIZONTAL| 
lstrepy (Style, ThHStyle) ; 
else 
Istrepy (Style, ThvStyle); 
// other styles (hopefully) handled 
// by Dialog Editor 
return lstrlen (Style) ; 
) // Xlatect1Plags( 
OCI ICICI IOI IDIOTS IA ATOR 
[II IIIT IOUT III IIIT IOO AA ATR 
// Dialog Box to modify control style 
rag 
// statics to remember between messages 
static HANDLE hctlstyle; 
static LPFNSTRTOID StrToId; 
static LPFNIDTOSTR IdTostr, 


LONG FAR PASCAL ThStyleDlgProc (HWND hD1g 
WORD wMessage, WORD wParam, LONG 1Param) 
{ // style dialog window procedure 
LPCTLSTYLE 1pCt1style; 
char Temp (32); 
switch (wMessage) 

{ 
case WM_INITDIALOG: 
lpet style 
= (LPCTLSTYLE) Global- 
Lock (hct 1Style) ; 
if (1pCtlstyle==NULL) return FALSE; 
// convert ID to string for editing 
(*IdToStr) (1pCt1style->wid, 
(LPSTR) Temp, 32); 
SetDlgItemText (hDlg, ID_IDEDIT. 
Temp) + 
SetDlgItemText (hDlg, ID_TITLEEDIT 
pct lstyle->szTitle) ; 
GlobalUnlock (hCt1Style) + 
break; 
case WM_COMMAND: 
switch (wParam) 


i 
case IDOK: 
// convert ID back to binary 
lpct1style = (LPCTLSTYLE) 
GlobalLock (hCt Style) ; 
GetDlgItemfext (hDlg, ID_IDEDIT, 
Temp, 32); 
ApCt1Style->wId = HIWORD ( 
(*StrToId) ((LPSTR) Temp) ) 7 
GetDigItemText (hDlg, ID_TIT~ 


LEEDIT, 
ipCt1style->szTitle, 
CTLTITLE) ; 
GlobalUnlock (hct1style) + 
EndDialog(hD1g, TRUE) ; 
break; 
case IDCANCEL: 
EndDialog(hDlg, FALSE); 
break; 
} 
break; 
default: 


return FALSE; 
} 
return TRUE; 
) // ThStyleD1gProc () 
JOR OR II II III III III IIR | 
BOOL FAR PASCAL Ct1StyleD1g(HWND hWnd, 
HANDLE het1style, 
LPFNSTRIOID lp£nStrTold, 
LPFNIDTOSTR lpf£nIdTostr, 
{ // display a dialog box to change 
// control styles 
FARPROC StyleD1gProc; 
BOOL result; 
//Save vital info for the dialog. 
hetlstyle = hctlstyle; 
StrTold=lpfnstrTord; 
IdToStr=lpfnIdTostr; 
//Show dialog box 
StyleDlgProc 
= MakeProcInstance ( 
(FARPROC) ThStyleD1gProc, 
hInstance) ; 
result=DialogBox (hInstance 
MAKE INTRESOURCE (IDD_STYLEDIALOG) , 
hWnd, StyleDlgProc)7 
FreeProcInstance (StyleD1gProc) ; 
return result; 
) // CtlstyleDlg() 


PIOISIOG IOI ODI IDIOT AI IIK / 


Figure 4 - THERMO.C, MS DigEdit Interface functions 


‘THS_VERTICAL’ or ‘THS_HORIZON- 
TAL’, Control classes with more styles 
would require more elaborate functions, 
creating a string of several constants separ- 
ated with ‘|’. 


Interface to Borland 


Probably prompted by the design of the 
Borland Windows Custom Control 
(BWCC) library (which contains several 
classes in a single DLL), programmers at 
Borland decided that Microsoft’s CCAPI 
was inadequate. They produced their 
own CCAPI for Resource Workshop 
which, although they say it is an ‘exten- 
sion’ of Microsoft’s version, is not an 
exact superset. 


To work with Resource Workshop, a cus- 
tom control DLL must export a function 
with the name ListClasses () (ordi- 
nal number is unimportant). List- 
Classes() returns a_ structure 
containing an array with pointers to the 
three previously mentioned functions for 
each control class in the DLL. While the 
CtlstyleDlg() and XlateC- 
t1Flags () functions given here are the 
same functions used in the MS CCAPI, 
CtlInfo() must change slightly (See 
Figure 6). 


RWCtlInfoO 


Borland added two new members to 
CTLTYPE, naming the resulting struct 
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————————S 


RWCTLTYPE (contained Borland’s version 
of CUSTCNTL.H, or in RWCUST.H [available 
on disk] if you’re using MSC++). The first of 
the new members is hToo1 Bit, which is 
a handle to a 24x24 bitmap which will be 
placed asa button on Resource Workshop’s 
toolbar. Clicking the new button will ‘load’ 
the cursor with the given control. If 
hToolBit is NULL, no button will be 
added, and you will only be able to access 
your custom control through the dialog 
produced by the ‘Control’, ‘Custom...’. 


The other new member is hDropCurs, a 
handle to a cursor. If non-NULL, the cursor 
will be changed to this shape when it is 
loaded with the given control. If NULL, a 
standard cross-hair cursor will be used. 


Accommodating Both 


As long as you can live with having only a 
single control per DLL, you can make your 
custom control compatible with both 
DlgEdit and Resource Workshop. Although 
the Microsoft and Borland methods each 
need different Ct 1 Info () functions, the 
functions are found in different ways - one 
via its ordinal in the exports, one via a pointer 
returned from ListClasses(). Just 
write two functions, each with a different 
name, as I have done for Thermo, and use 
them in their rightful places. 


Compiling 

I compiled Thermo using Microsoft C/C++ 
7.0. With its Programmer’s Workbench, I 
selected a ‘Windows 3.1 DLL’ project tem- 
plate, then added the files THERMO.C, 
‘THERMO.RC, and THERMO.DEF. At first, 
the DLL wouldn’t register properly in 
DigEdit. I noticed that the options for func- 
tion entry code were set for -GD (protected 
mode DLL entry code), while those in an 
example program were set to -Gw (real 
mode DLL entry code). After changing the 
PWB Global options entry code selection to 
‘None’ (to remove the -GD) and adding -Gw 


Windows Custom Controls 


OIC ISS G ESS IIIISIISI IIIIIOT 
// Bxtra functions for Resource WorkShop 
// compatibility. 
Mf 
void SetRWCtl Type (LPRWCTLTYPE CT, 
WORD Type, WORD Width, WORD Height 
DWORD Style, LPSTR Descr 
WORD ToolID, WORD CursID: 
{ // set the fields of a RWCTLTYPE 


cT->wrype = Type; 
cT->wiidth = Width; 
CT->wHeight = Height; 
CT->dwStyle = Style; 


1strepy (CT->szDescr 
if (ToolID 
C?->hToolBit = LoadBitmap(hInstance 
MAKEINTRESOURCE (TOOLID) ) 7 


Deser); 


else 
CT->hToolBit = NULL; 
if (CursID) 
CT->hDropCurs = LoadCursor (hInstance 
MAKEINTRESOURCE (CursID) ); 
else 
CT->hDropCurs = NULL; 
) // SetCtltype () 
ROCIO IOI IIO TI OJOS IIIT ISO III / 
// RWCt1Info() - create & return a handle 
// to info structure (for Res. WkShop’ 
HANDLE FAR PASCAL RWCt1Info(void 
{ 
LPRWCTLINFO pCI; 
HANDLE her; 
//Allocate an INFO struct 
hCI=GlobalAlloc (GMEM_MOVEABLE, 
sizeof (RWCTLINFO) )+ 
if (hCI==NULL) return NULL; 
7/ get a pointer to it 
pCI= (LPRWCTLINFO) Global Lock (hCI) ; 
if (pCI==NULL) 
\! 
GlobalFree(hCI) ; 
return NULL; 


) 


// init data items 
SetCtlInfo((LPCTLINFO)pCI, 0x100 
2, ‘ThName, ThName) ; 
SetRWCtl Type (& (pCI->Type(0}), 0, 20, 60, 
WS_CHILD | WS_VISIBLE | THS_VERTICAL, 
ThVDescr, ID_VERTBIT, NULL); 
SetRWCtl Type (&(pCI->Type[1]), 0, 60, 20 
WS_CHILD | WS_VISIBLE | THS_HORIZON- 
TAL, 
ThHDescr, ID_HORBIT, NULL); 
// send handle to info to Res. 
GlobalUnlock (hCI) + 
return hCI; 
} // RWCt1Info() 
PORE IO OOS IIOSOE SITIO IOI IIIA 
// Do not change this function’s name!! 
HANDLE FAR PASCAL ListClasses ( 
LPSTR szAppName, WORD wVersion, 
LPENLOADRES fnLoad, LPFNEDITRES fnEdit 
{ // construct a list of all classes 
// in this DLL 
HANDLE hClasses 
= GlobalAlloc(GMEM_SHARE | GMEM_ZE- 
ROINIT, 
sizeof (int) + sizeof (RWCTLCLASS) ); 
if ( hClasses ) 


WkShop 


{ 
LPCTLCLASSLIST Cl = (LPCTLCLASSLIST) 
GlobalLock (hClasses) ; 
Cl->nClasses = 1; 
Cl->Classes(0}.fnRWInfo = RWCtlInfo 
Cl->Classes(0].fnRWStyle = Ctlsty- 
leDlgs 


Cl->Classes(0].fnFlags = XlateC- 
tiFlags: 
Lstrepy (C1->Classes (0) .s2Class, 


ThName) ; 
GlobalUnlock (hClasses) ; 
, 
return hClasses; 
) // ListClasses() 
/#eHOO end of thermo.c *#ee RARER 


Figure 6 - THERMO.C, Resource 


to the list of ‘other options’, I recompiled 
and everything worked fine, Being late as 
usual, I didn’t have time to investigate 
exactly why the protected mode version of 
entry/exit code didn’t work properly. 


By building a project for a Small model 
Windows DLL, removing the reference to 
RWCUST.H, and erasing the (WNDPROC) 
typecast, this program will also compile 
with Borland C++, Be sure you set the op- 
tion to use the C++ compiler only for .CPP 
files, otherwise the export names will be 
generated incorrectly. 


Summary 


To create a custom control DLL usable by 
both MS DlgEdit and Resource Workshop,: 


7] CDHERMO. HOSE OOOO IOS IR AAI IO 
// messages 


define THM _SETRANGE (WM_USER+1) 
#idefine THM GETRANGE (WM_USER+2 
fidefine THM_SETTEMP  (WM_USER+3 
define THM_GETTEMP (WM_USER+4 
fdefine THM RAISE — (WM_USER+5) 
#define THM_LOWER —(WWM_USER+6) 
// styles 


#define THS_VERTICAL = 1. 

#define THS HORIZONTAL 2 

7] THERMODLG..2 SSS HO UCC EERE Re 
// dialog box IDs 

#define IDD_STYLEDIALOG 50 

#define ID_HORBIT 51 

#define ID_VERTBIT 52 

// dialog item IDs 

#define ID_IDEDIT 100 

#define ID_TITLEEDIT 101 

7] THERMO. RC SHEESH ESSE SOS SO HE 
#include <windows.h> 

#include "thermo.h" 

#include "thermdlg.h" 


rceinclude thermdlg.dlg 
ID_HORBIT BITMAP thermhor .bmp 
ID_VERTBIT BITMAP thermvyrt .bmp 
7/ORHERMODLG. DLG CEES IIR RH 
IDD_STYLEDIALOG DIALOG 52, 61, 153, 73 
STYLE DS_MODALFRAME | WS_POPUP | 
WS_VISIBLE 

| WS_CAPTION | WS_SYS~- 
MENU 
CAPTION "Thermo Style Information" 


FONT 8, "MS Sans Serif" 
BEGIN 
RTEXT "Text:", -1, 3, 10, 19, 8 
EDITTEXT ID_TITLEEDIT, 23, 9, 122 
12, ES_AUTOHSCROLL 
RTEXT "ID", -1, 2, 30, 20, 8 
EDITTEXT 1D_IDEDIT, 23, 29, 63, 
12, ES_AUTOHSCROLL 
DEFPUSHBUTTON "OK", IDOK, 20, 50, 40, 18 
PUSHBUTTON "Cancel", IDCANCEL, 
92, 50, 40, 18 
END 


Figure 5 - Misc Support files for Thermo project 
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Workshop Interface extensions 


@ Write a LibMain() which registers 
the class, anda WndP roc () to process 
the control’s messages. 


@ Write CtliInfo(), cCklsty= 
leDlg(), and XlateCt1Flags () 
functions and list them in the exports as 
ordinal 2, 3, and 4, 


Write a RWCt1 Info () function simi- 
lar to CtlInfo(), but using the 
RWCTLTYPE and RWCTLINFO struc- 
tures, and ListClasses () function 
which gives the addresses of 
RWCtlInfo(), Ct1lDlgStyle() 
and XlateCt1lFlags(). Export 
ListClasses() with any ordinal 
you like, but don’t change its name. 


[EXE] 


The full source to an ‘improved version’ 
(promises Laine) of the code can be ob- 
iained by sending in a disk as per the rules 
laid out on Page 3, column 1. Please mark 
your envelopes ‘CONTROL’. 


Laine Stump is a C++ programmer who 
believes that, if C columnists can write about 
C++, he can damn well write about C. 


Laine now has an email address: 
laine@trbilun.bitnet. He can 
also be contacted by fax at 010 90 4 418 
5779, or post at Bilkent University, Loimantar 
3/9, 06533 Bilkent / Ankara, TURKEY. 
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UNIX 
SCO Unix Op. Sys SCO Dev elopment Sys. 
SCO Open Desktop (new version 2) 
SCO TCP/IP & NFS FTP PC/TCP 
Interactive Unix Op Sy stem/ Architect Series 


Informix 4GL & SQL RM Cobol-85 
LPI Fortran C Scape Screen Lib 
LPIC++ for 386 Unix & Sun- NEW 


Word Perfect for Unix 
Defragmenters & other utilities 
... many more for 386 Unix and Sun 


Mathematics 
Derive - Mathematical Assistant ver 2.5 
Derive also for HP95LX Palmtop 
Mathematica - Edition for Students 
Mathematica Win, 386, Mac, Workstations 
MathCad for Windows Origin Plot 
What’s Best! Lindo Linear Prog 
Gauss Chiwriter Sci WP 


Windows Development 
(see Microsoft , Borland, Zortech, Watcom) 
ProtoView £295.00 
HALO Image Format File Windows £195.00 
CASE:W 4.0 for MS C/C++, BorAFW £595.00 
Smalltalk/V Windows - new ver 2 £295.00 


PCX ProgToolkit Windows £139.0 
INSTALL Shield £245.00 
TBXShield £245.00 


rossDevelopment 
2500AD Cross Assemblers £129.00 
Hitech C Cross Z80, 805, 68HC11.. £395.00 
Introl C or Mod-2 Cross Comp-6809, 68K 

Aztec C68K, Avocet CCross £call 


Pascal (see Borland) 
TopSpeed Pascal SE £115.00 
Object Professional £99.00 
Btree Filer MU £99.00 
Asynch Professional £79.00 
Blaise Turbo Vision Toolkit £95.00 
Blaise Asynch Plus £115.00 
PCX Programmer's Toolkit £145.00 


Power Basic £85.00 
many Basic libraries for comms, graphics 

PC Logo - new ver 4.0 

LMI UR/Forth 

Smalltalk V/DOS 

muLISP 90 

RM Cobol-85 (new Dev Pack) 

MS DOS 5.0 upgrade 

DesqView/X NEWI!! 


¢ Prices are exclusive of VAT. 

¢ Prices (except upgrades) include 
delivery to mailand UK. 

Prices are subject to change. 

¢ VISA, Access and Mastercard 
welcome with telephone orders. 


Microsoft 
MS C/C++ 7.0 with Win 3.1 SDK 
Quick C for Win 

MS Fortran 5.1 

MS Test for Windows NEW!! 


C++ & C Compilers 
also Microsoft & Borland 

Zortech C++ Dev Ed (incl 32bit) £345.00 

£175.00 


£225.00 

£89.00 
£215.00 
£225.00 


MS Windows SDK 3.1 £225.00 | | JPI TopSpeed C++ SE £115.00 
acro Assembler 6.! | 

Visual Basic for Windows 99.00 | |JP! TopSpeed C++ PE £175.00 
VB Prof. Toolkit NEW! 2149.00 | |Metaware High C/C++ 386 Eccl 
MS C 6.0 for DOS & OS/2 £225.00 | |Watcom C 9.0 £275.00 
MS Quick C 2.5 with ASM 95.00 | |Watcom C/386 9.0 new £475.00 
Visual Basic for MS-DOS F\/\fesa.00 00 : 

Visual Basic for MS-DOS Prd 995,00 | [Aztec C 86 (with ROM support) £255.00 


call to upgrade to Visual Basic for MS-DOS 


from Quick Basic and Basic PDS 


IDS 
Authorised Languages Dealer | | C++/Views Win,OS/2, Motif 


Zinc Win & Dos (source) ver 3.0 
Poet (OOPS Database) 
Greenleaf Comm++ (source) 
Win++ by Blaise 


C Datafile 
CodeBase 4.5 for C, C++, Win- new 
Btrieve - DOS or Windows ver 
Ctree Plus from Faircom £310.00 
Faircom Professional Toolbox £745.00 
Watcom SQL Client/Server Dev Ed. £225.00 
C Communications 
Essential Comms 
Greenleaf CommLib 
C Asynch Manager (Blaise) 
creens 


£call 
£275.00 
£call 
£115.00 
£149.00 


Borland 

Borland C++ & AFW ANE 
Borland C++ (Dos / Win) 
Turbo C++ Windows new 3,1 
Turbo Pascal Windows new 1.5 
Turbo C++ ver 3.0 NEW!! 
Turbo C++ with Bor land C++ Video 
Turbo Pascal 6 £69.00 
Paradox Engine £99.00 

Authorised Languages Dealer 


Nu-Mega Tech. 
Bounds Checker 2.0 ...new £129.00 
Soft-Ice/W ( Windows) £239.00 


£295.00 
£199.00 
£85.00 
£85.00 
£52.00 
£69.00 


£189.00 
£345.00 


£175.00 
£185.00 
£115.00 


CScape with Look & Feel £365.00 
with free ‘Undocumented Windows' book q 
Soft-Ice (for 386 DOS) £239,00 | {Vermont Views 3 4 


Panel Plus I! (now withWin support) 
Graphics 


Intersolv (Authorised) Essential Graphics Kernal £125.00 
PVCS Version Control £345.00 | |PCX Programmers Toolkit £139.00 
PVCS Config Build (PolyMake) £175.00 | |X Graphics £199.00 
PVCS Networks, OS/2 & Sun £call HaloProfessional £195.00 


Metawindows 4/32 - NEW 
Misc. Libs 


£225.00 


Call to upgrade to new ver 5.0 PVCS 


Install& Internat ional Option £195.00 
MKS C Tools Plus £95.00 
MKS Toolkit ver 3.2, with Vi £149.00 Bar Code Library- source £245.00 


MKS RCS & Make - Config. Manager £149.00 
MKS Lex & Yace forC, C++&TP £175.00 


+» Many more libraries 


Pharlap 386 DOS Ext with ASM386 £310.00 


_ Lifeboat Pharlap 286 DOS Ext SDK £310.00 
Dan Bricklin's Demo II £155.00 | | Pharlap 386 ASM/Link/LOC £775.00 
PLink 86 + £245.00 
TimeSclicer £195.00 


ED for Windows call for Demo Disk £145.00 Fortran Compilers 


dl a Lahey FFFLCEMIS2 now lair 01 S840 
Borland Brief 3.1 £99,00" || | anes Dew \a5iel- 2 : 
Kedit (Xedit for PC) new ver 5 £99.00 | |Grtaphoria for F77L-EM/32 £225.00 
-RTLink Plus £295.00 Watcom F77 386 9 with ADS supp £475.00 
Ghost (auto. software testing) £125.00 | |Salford FTN 77-386 ; £765.00 
Select Case - Yourdon or SSADM £495.00 | |PC/Interacter (scrns & graphics) £325.00 
EasyCase Plus £315.00 Halo Professional for Fortran £195.00 
PCLint 386 £135.00 | |... many Fortran Libraries 
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> CIRCLE NO. 407 


XxBASE 


xBASE 


QBE for Clipper 


Guy Smith releases the power of Clipper’s OO to create a useful descendant of TBrowse. 


By now, the inclusion of a fixed class sys- 
tem in Clipper 5.01 will be apparent to most 
users, In recent months, several articles 
have already introduced third party add- 
ons such as SuperClass and Class(y) which 
offer class creation facilities similar to those 
coming in the next release of Clipper. This 
article details a Query By Example class for 
Clipper 5.01 written using SuperClass. 


The aim of this article is to provide a pro- 
grammable/controllable Query By 
Example facility, to provide an example of 
a complex class (classic examples of classes 
such as queue, stack and list offer insuffi- 
cient incentive for Clipper programmers to 
change their programming style), to pro- 
vide a practical example of inheritance and 
encapsulation. 


The problem is explained in three stages: 
from the viewpoint of the user, from the 
viewpoint of the programmer using the 
Query By Example class, and from the 
viewpoint of the programmer creating the 
Query By Example class. 


QBE for the User 


Query By Example (QBE) is an end-user 
tool for describing a set of records. Tradi- 
tional methods for allowing the user to 
describe a set of records at run-time include 
manually typing an English-like express- 
ion, manually entering a SQL expression 
(or an expression in the host language eg 
Clipper) and building an expression piece 
by piece using an expression builder. 


The first two can be dismissed as unnecess- 
arily unfriendly. The third is generally 
thought to be friendly, but rapidly becomes 
cumbersome and confusing when used to 
build complex expressions involving 
boolean logic. Users find it awkward to 
express which relationships are ANDed, 
which are ORed and to what expression or 
expressions a NOT applies to. 


QBE has been available in Paradox since its first 
release, and more recently appeared in dBase 
IV and FoxPro. QBE offers the user a matrix 
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within which to enter criteria, Each column 
of the matrix is typically headed by a field 
name. Thus to express the condition ‘all 
customers located in Nottingham’ the user 
moves the light bar to the row beneath the 
TOWN heading and types ‘Nottingham’. 


QBE is simple to use, but where it scores 
over more traditional techniques is that it 
carries on being simple to use even as the 
complexity of the expression increases, 
To express an AND condition (eg ‘all cus- 
tomers located in Nottingham AND the 
last date of contact was before 1st January 
1992’) the user enters ‘< 01/01/92’ in the 
LAST CONTACT column on the same row. 
To express an OR condition, subsequent 
conditions are placed on different rows. 
The user can clearly see which conditions 
are ANDed and which conditions are 
ORed by their placement on the screen, 


Such a high-level feature is typically outside 
the scope of the Clipper language, and pro- 
grammers are expected to build the feature 
themselves using Clipper primitives. 


QBE for the Programmer 


As we will be writing the QBE class, the 
scope, power and facilities of the QBE are 
directly under our control. Whereas Para- 
dox and dBase IV programmers need make 
no effort to incorporate QBE facilities into 
their programs, one drawback is that they 
have minimal or no control over the result 
and its extensibility is limited. 


For the sake of brevity, the QBE designed 
here will be limited. It will be a flat file query 
(ie it will not be possible to create multi 
table queries). The demonstration code will 
not support adding calculated fields 
(though the class will support this). 


The code in Figure 1 demonstrates a simple 
modal use of a QBE. It opens any file, 
creates a new QBE using QBENew () and 
initiates a loop that repeatedly calls 
QBEModal () (which returns control to 
the user to enter a query) and then lists the 
records which match that query. 


At the highest level, therefore, the pro- 
grammer needs to know how to create the 
query (QBENew () ), how to let the user 
enter the query (QBEModal () ) and how 
to write code which uses the query entered. 
From the code in Figure 1 you can see that 
the FOR condition of the LIST command 
contains ‘eval (OQBE:exprBlock)’. 
The exprBlock instance variable of the 
QBE class always contains a code block 
which evaluates to a true or false depend- 
ing on the query entered. 


Beneath this superficial layer lies the 
code which directly manipulates the QBE 
object. For many programmers this layer 
would never be manipulated. For this 
next step, a knowledge of the QBE class 
is necessary. 


QBE Class Explained 


Obviously from the examples given earlier it 
can be seen that queries are entered into a 
matrix, The Clipper language supports two 
kinds of matrices: DBF files and multidimen- 
sional arrays. Of the two, the more flexible is 
multidimensional arrays. In addition, arrays 
are faster for small numbers of rows and can 
be encapsulated within an object. 


A significant part of the query class will be 
the representation of the query on the 
screen. For this part, Clipper already pro- 
vides a powerful and flexible class: 
TBrowse. So the query class will be re- 
markably similar to TBrowse, and can be 
inherited from it. In addition it will contain the 
data which is being browsed (ie the query 


function Main() 

local oQBE 

set ScoreBoard off 

* set offensive colour scheme ON 

set color to W+/B, GR+/G,,,GR/G 

use anyfile 

OBE : =QBENew () 

do while .not. lastkey()==K_ESC 
QBEModal (oQBE 
clear 
list fieldGet (1), fieldGet (2),; 

fieldGet (3) for eval (oQBE:exprBlock 

inkey (0) 

enddo 

return (NIL) 


Figure 1 - 
Simple modal use of QBE Class 
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matrix) and also several additional methods 
and instance variables which allow man- 
ipulation and interrogation of the query. 
Figure 2 shows the QBE methods and in- 
stance variables, although I have deliber- 
ately omitted those inherited from 
TBrowse. 


Like TBrowse the QBE class contains col- 
umns. Figure 3 shows the QBECo1umn meth- 
ods and instance variables with the exception 
of those inherited from TBColumn. 


QBENewQ 


QBENew () is a function which takes the 
drudgery out of creating a new QBE object. 
Itaccepts an array of the structure to query 
and defaults this to the structure of the 
currently selected file. It creates a new 
query in the line 


local oQBE:= 
qbe() :new(4,1,11,78) 


and adds oQBEColumn objects for each 
field defined in the structure array. Notice that 
the OQBEColumn : new () class construc- 
tor accepts three parameters. The first is the 
QBE object, the second is the column heading 
and the third the column expression (prob- 
ably the field name). Thus the QBE class 
already scores over it’s contemporaries in 
being able to display the English names of 
fields (possibly loaded from a data dictionary) 
as opposed to ugly field names. 


QBEModalQ) 


QBEModal (), shown in Figure 4, is 
similar to Clipper’s own ReadModal () 
in purpose; it assembles all the QBE fea- 
tures in an intelligent way. Note, how- 
ever, that QBEModal () is deliberately 
left as a function which is under the con- 
trol of the programmer and not as a 
method of the QBE class. There are two 
reasons for this. First, as its name implies, 
QBEModal () is modal and, therefore, 
places an unnecessary design constraint 
upon user of the class ie that the user 
interface is modal and cannot be event 
driven, Second, QBEModal () is simply 
one way of doing this job. In this respect, 
QBEModal () is directly analogous to 
the way Clipper’s own BROWSE () func- 
tion assembles the TBrowse class : it is 
useful, but does not exploit the class to its 
full potential and is not adaptable. 


QBEModal () treats the QBE object 
just like a TBrowse object. QBEMo- 
dal () paints the screen and initialises 
a loop which stabilises the query, ac- 
cepts keystrokes, acts on predefined 
keystrokes using TBApplyKey () 
(which saves the drudgery of writing 
out all the TBrowse methods and 
corresponding keystrokes) and detects 
an attempt to enter data into the query. 
When such an attempt is detected it 
calls QColGet (). 


XBASE 


QColGet (), shown in Figure 5, can extract 
the relevant cell to be entered/edited from the 
query as it can find both the current row 
(OQBE : rowPointer) and the current col- 
umn(oQBE : colpos), Itoffersthistotheuser 
at the current screen row and column and then 
attempts to assign it back to the column using 
oCol:assign(cEntry, oQBE:row- 
Pointer). QBEColumn:assign() can 
reject the assignment if the cell has some 
logical inconsistency (eg the cell attempts 
to do division on a date field). 


QBE for the class writer 


As will be apparent by now, the majority of 
work is performed by TBrowse and 
TBColumn, All instance variables and 
methods are inherited and for the large part 
used ‘as is’. However, the QBE class has a 
few additions and differences. 


For example, the class constructor also en- 
sures that the TBrowse: goTopBlock, 
TBrowse:goBottomBlock and 
TBrowse:skipBlock instance vari- 
ables are set. As the data for query and the 
query row pointer are encapsulated within 
the query itself, it is a matter of simplicity to 
set them immediately, 


The QBE class maintains a count of the num- 
ber of rows in the query so that new columns 
can be added at any time (say, for adding 
calculated or related fields) and the new col- 


Instance variables 

qRowCount The number of rows in the query 

rowPointer The current row in the query 

ExprClip A string of the query in Clipper code 

ExprUser A string of the query in English 

ExprBlock A code block of the query 

Methods : 

Reset() Clear down the query 

Settle() % Settles the query after an assignment 

AddRow() Add a new row to all columns 

DelRow(nRow) Delete an existing row from all columns < 

ExprUserDisplay() Display the English query in a box 

ExprClipUpdate() Update the ExprClip after a query change 
| Expert Update the ExprUser after a query change 


Figure 2 - QBE Instance variables and methods 


Figure 3 - QBEColumn Instance variables and methods 


function QbeModal (oqbe) 
local lAutoEntry,nkey 
ScrNew('Selection Criteria’) 
@ 12,1 say replicate (’’,maxCol()-1) 
oQBE: ExprUserDisplay () 
oQBE: refreshall() 
do while .t. 
status (‘F2/Esc-Finish,F3-Clear ‘+; 
‘query, <-Edit criteria’) 
do while nextkey()==0 .and. ; 
snot, oQBE:stabilize() 
enddo 
nkey:=inkey (0) 
do case 
case TBApplyKey (oQBE, nkey 
case nkey==K_ESC .or. nkey==K_F2 
exit 
case nkey==K_F3 
if YesNo(/Clear down enquiry ‘+; 
‘and start again ?') 
OBE: reset () 
OQBE:refreshall() 
oQBE:ExprUserDisplay () 
endif 
case (lAutoEntry:=(upper (chr (nkey)) $; 
" ABCDEFGHIJKLMNOPORS ‘+; 
‘TUVWXYZ1234567890=>$<!)) ; 
sor. nkey==K_RETURN 
* edit criteria 
if lAutoEntry 
* do not waste the key pressed 
* stuff it back into the keyboard 
keyboard chr (nkey) 
endif 
qColGet (oQBE) 
endcase 
enddo 
return (NIL) 


Figure 4 - QBEModalO - A modal 
use of the QBE class 
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umns can adopt the full complement of 
rows. Indeed QBE:addColumn() dis- 
places the TBrowse:addColumn () 
method so that it can ‘flesh out’ new columns 
as they are added. 


The QBE:settle() method is typically 
called after assigning a value to a cell in the 
query matrix. The purpose of 
QBE:settle() is to ensure that there is 
always one and only one blank row as the last 
row of the query. To do this, it repeatedly uses 
QBE:A11ColumnsBlank () method to 
decide whether the query contains em- 
bedded blank rows, multiple blank rows or 
no blank rows and uses QBE: del Row () 
and QBE : addRow () to correct any prob- 
lems that it finds. 


The QBE:exprClipUpdate() and 
QBE:exprUserUpdate () methods are 
the real intelligence of the QBE class. They 
assign the correct strings to the QBE:ex- 
prClip and QBE:exprUser instance 
variables appropriately. In addition 
QBE:exprClipUpdate () also ensures 
that, as it changes QBE:exprClip, it also 
creates the appropriate code block for 
QBE:exprBlock. 


Both update methods work in the same way. 
For each row they process each cell. An ex- 
pression is generated for each cell based on 
the QBECol : exprClip (for Clipper) and 
QBECol:heading (for the user). Data 
types are converted from character to the 
necessary data type to perform comparison 
as needed, Each cell is ANDed with each 
other cell on the same row and the whole row 
enclosed in parenthesis to ensure correct 
evaluation. Each successive row is ORed with 
previous rows. 


As each cell is evaluated, simple features are 
processed, For example, the keywords NOT, 
BLANK and TODAY, case insensitivity for 


function QColGet (oQBE) 


local nError:=0 

local ‘ow() 

local 01 () 

local OBE : get column (oQBE:colpos) 


local getlist 
local cEntry:=0Col: rows (oQBE: rowPointer 
do while .t. 
@ nRow,nCol get cEntry picture '@S10 
read 
if lastkey ()==K_ESC 
exit 
endif 
nError:=oCol:assign(cEntry, ; 
oQBE: rowPointer) 
if nError==0 
oOBE: settle () 
exit 
else 
Alert (‘Invalid entry’, 
endif 
enddo 
oQBE:ExprUserDisplay () 
oQBE: refreshall () 
return (NIL) 


{"0k’)) 


Figure 5 - QColGet() - 
Edit the currently highlighted cell 
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0 assignment accepted 
“1 no parameter following operator 
-2 no space following operator 
<3 ‘contains’ operator can only be used with character/memo data 
-4 usage of both ‘contains’ operator and ‘substring’ operator is a logical contradiction 
5 ‘substring’ operator is not supported for non-character data 
-6 relational operators cannot be used with BLANK keyword 


Figure 6 - QBECol:assignO return codes 


character strings and the importance or other- 
wise of trailing spaces are all catered for. 


For the QBECol class, the methods are 
straightforward, and the intelligence of the 
class lies in the QBECol: assign () 
method. QBECol():assign() vali- 
dates a new value for a cell and accepts or 
rejects the assignment on this basis. In effect 
itis a simple parser. Figure 6 shows the return 
codes and corresponding meanings. 


Note thatthe QBECo1 class does not contain 
a code block of the expression represented 
by the column (ie a fieldname in all prob- 
ability). The expression is always represented 
by a character string. This might seem primi- 
tive, as we are all being encouraged to use 
code blocks instead of macro substitution 
(and quite right too), butin this case the query 
is better optimised by avoiding individual 
code blocks. The problem is that the pro- 
grammer needs a single instance variable 
containing a code block which evaluates to 
true or false. If every field is represented as a 
code block, the QBE code block would con- 
tain a large number of EVAL () s. The con- 
catenation of field name strings and 
compilation of the expression in its entirety is 
a significantly faster solution. 


Potential Improvements 


My example has been kept simple for demon- 
stration and explanation purposes. However, 
areal world Query By Example would benefit 
from a number of improvements. 


The facility for the user to add columns to the 
query helps to model real world relation- 
ships. With the addition of an expression 
builder, calculated or virtual fields could be 
added and then queried as any other field. For 
example, it should be possible to query a 
calculated field TOTAL COST, where 
TOTAL COST is the product of fields 
QUANTITY and PRICE. 


Perhaps more importantly, the query should 
allow a set to be described based on informa- 
tion supplied by related files. For example, it 
should be possible to select all invoices for 
which one of the line items is ‘widgets’. Such 
an enhancement implies the existence of an 
active data dictionary which could be called 
upon to supply relevant information about 
relationships. 


An easier enhancement would be to add a 
method such as QBE: exprSQL (), which 
would create a SQL expression based on the 
query matrix. 


Finally, it is possible to write generic routines 
which dissect the query and attempt to use 
available indexes to optimise the query. At the 
simplestlevel, the routine would look for single 
field enquiries of exact matches eg all com- 
panies based in Nottingham. The optimisation 
routine would look for an index based on the 
CITY field and, if found, perform a SEEK 
"NOTTINGHAM", Itis possible to write more 
intelligent optimisation routines (as Fox Soft- 
ware has done for FoxPro 2) but even the most 
simple will reap great time savings. 


Use 


Theuse fora programmable Query By Example 
isnotlimited toan ad hocreport writer. Itwould 
bea relatively simple matter to allow the user to 
pop up a fresh query window from within a 
browse and allow colour settings for a set of 
records to be set according to a query. The 
number of query/colour setting combinations 
need not be limited to 1. Thus the user could 
browse a full table and easily identify records by 
the colour in which they are displayed. 


Summary 

Query By Example is a powerful and easy to 
use tool for users. Presented as a class it is both 
flexible and easy to use for the programmer. 
The same facility presented only as a set of 
functions is not nearly as flexible. 


Guy Smith is a freelance writer and has de- 
veloped in Clipper since the Winter ‘85 release. 
He is the author of the Capella Library, an 
application development library for Clipper 5, 
and co-author of a Programmer's Reference to 
BPS’s Visual Interface Library, which we 
haven't reviewed yet - sorry Guy. Guy can be 
contacted on CompuServe at 100014, 1724 or 
on GIX as smithg. 


‘The full source code to Guy’s QBE class, 
together with an example application, can be 
obtained by sending in a disk as per the rules 
laid out on Page 3, column 1. Please mark 
your envelopes ‘QBE’. Note that the QBE 
class code requires SuperClass 2.1. 
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You don't give it away. 
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MAXPRO encryption even copes with such as Clipper, QB and 
Clarion files with internal overlays. Neat trick. There are 
dongles available for Windows applications too! Call us for 
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Founded some 20 years ago, the Institution is 
Britain’s leading specialised professional body for 
systems analysts and computer programmers. 


The Institution’s primary aim is to promote 
vocational skills and professionalism. It also seeks 
to support members in a number of practical ways. 
Members are entitled to use the Institution's 
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engaged in systems analysis or programming, and 
from those training for the profession. 


* 


Telephone Fax 
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SOFTWARE SECURITY 
MODULES 


Hardware devices (dongles) are a recognised and 
proven means of protecting software from 
unauthorised use and pitacy. 


Our range of devices offers some of the most robust 
and troublefree solutions around. All units are 
cascadeable and can be uniquely coded for each 
customer. Features include: 


Back-up problems 
Hardware add-ons or special disks needed 


Changes to source code required 
* PC/non-PC. %* Software drivers supplied. 


% RS232/Printer. % Minimum 2 year 


* Internal memory guarantee. 
(some units) * From £14 to £50 


CopyControl beats ALL bit-copier Programs 
Floppy disks, hard disks and 

networks supported 

CopyConttrol is totally transparent to the user 
You can limit program use by no. of copies, 
no. of executions or date 


CopyControl works on all IBM compatibles 


Free demo disk available 
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Telephone: 0272441230 Fax: 0272-427295 
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SCO Open Desk Top Release 2.0 


The Santa Cruz Organisation has recently delivered Release 2.0 of Open Desk Top. 
Alain Williams takes a look at some of its major features. 


Open Desk Top (ODT) is intended to be 
SCO’s answer to Microsoft’s Windows 3. It 
is advertised as providing a ‘UNIX-based 
integral graphical environment’. The 
graphical emphasis is perhaps misleading, 
as there are many other good features. 
Open Desk Top contains the following 
components: 
ey 
@ X Windows (Motif) based graphical in- 
terface. 


@ TCP/IP Networking: telnet, ftp, snmp, 
LAN Manager and the UNIX r com- 
mands. 


@ A PC Interface consisting of a DOS file 
server and login support. 


@ Enhanced file system support: NFS, 
EAFS (a fast file system with long names 
and symbolic links). 


@ NIS (explained below). 


@ DOS under UNIX with Locus’ Merge, 
providing DOS 5.0, LIM 4.0 support. 


@ Security to the DOD C2 level. 


Despite the emphasis on graphics, most 
ODT applications are (still) character 
based. These can be run either ina ‘terminal 
window’ on the desk top (with X-term), or 
ina full screen, text mode console window 
-I prefer the latter as it is faster and the text 
is bigger. There is an SCO catalogue listing 
several hundred graphical applications, 
and more are being developed. 


Graphical Interface 


As mentioned above, the Graphical Inter- 
face is based on the X windowing system. 
It provides a prettily coloured ‘desk top’ 
with icons, menu bars and all the usual 
mouse-driven gizmos. You are probably 
used to the Windows 3 environment: super- 
ficially this is the same. On top of X Win- 
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dows, ODT uses the OSF Motif Widget 
Toolset, a set of application libraries de- 
signed to produce a uniform look and feel 
to graphical applications, The desk top en- 
vironment itself is [XI’s X.desktop 3.0 -a UK 
product. 


To do real work, you will need to buy some 
third-party applications. SCO does provide 
a few applications to get you started: a 
mailer (send/view e-mail), X-term (which 
gives an ASCII command-line session), and 
the usual clock, calculator, draw and pref- 
erence configuration utilities. 


I tested the environment using a third party 
typesetting package (eroff). This worked 
well enough, although it occasionally 
crashed, I think because eroff doesn’t con- 
form to Motif rather than an SCO problem. 


There were some irritations. For instance, 
the hot key sequence to shut a window/ap- 
plication varied considerably between the 
SCO supplied applications. If they can’t get 
it right, why should anybody else be bo- 
thered? It is these little things which really 
make you understand how important it is 
to conform to standards - whether you like 
them or not. 


Another irritation is that ODT is based on X 
Windows version 11.4. Version 11.5 has 
been available since August last year, and 
many other UNIX vendors supply it. This is 
slackness on SCO’s part. 


Networking 


To anyone who uses UNIX and UNIX- 
based networks every day, there will be few 
surprises here. The networking system is 
based on TCP/IP and provides the usual 
abilities, of which the most important are: 


@ NFS. This is the UNIX file system sharing 
protocol. It allows you to treat a file 
system on another machine as part of the 
file system on your local machine, which 


is incredibly useful. NFS is also available 
for many other platforms, including 
Apple Mac, VAX/VMS and IBM MVS, 
One note: RES, the USL provided version 
of NFS, is not supported - but this is not 
a great loss. 


@ Telnet/rlogin. Remote login to and from 
other machines. This means is that, with- 
out leaving your local machine, you can 
login to another machine and work just 
as if you were sitting in front of it (well, 
almost). 


@ FTP. This allows you to copy files be- 
tween machines on the network - some- 
thing you do when the option of remote 
mounting the file system is not available. 


@ NIS. An admin tool which ensures that 
passwords are kept consistent for a user 
across the network, NIS does have its 
problems, but is a useful tool in mana- 
ging a UNIX network. 


@ Sendmail and SMTP. These are elec- 
tronic mail utilities, very useful - but a 
devil to configure. 


@ PC-Interface (from Locus), DOS ma- 

chine connectivity. This provides access 
to the UNIX file system as a virtual D: 
drive, and the ability to use a DOS box 
as a VT220 (ANSD terminal and login to 
the UNIX host. PCI works over either 
Ethernet or RS-232 lines. I tested it over 
Ethernet, and found that loading files 
over the network is about as fast as from 
an (old and slow) 80ms local disk. It is 
very usable. 
Two negative points, You cannot see the 
DOS disk from the UNIX host (which 
would be handy), and you need to buy 
extra software from Locus at about £130 
per DOS machine. 


Note that much of the above won't be very 
useful to you if you run a Novell IPX/SPX 
network. In fact, SCO has only just an- 
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nounced support for this. At time of going 
to press I have yet to see it. SCO says that 
the facility will cost you about £300 extra, 
and will probably be bundled into the next 
release of ODT. It will supply the protocol 
stack, mvt (login) and an API, but you will 
have to wait longer for a version that works 
as a Netware client. There are no plans to 
make it a Netware server (shame). 


Products are also available for IBM main- 
frame, OSI/X.400 connectivity, 


Enhanced file systems 


In addition to NFS (discussed above) SCO 
supports seven other file system types. Five 
of these are various UNIX and XENIX file 
system variants (mainly to do with different 
block sizes), but there is also ‘EAFS’, which 
is similar to the BSD Fast File System, and 
supports long file names (up to 255 charac- 
ters) and ‘Symbolic Links’, 


Symbolic Links allow you to reference 
somewhere on another file system (poss- 
ibly on another machine) but using a name 
that appears to be in the first file system. 
Imagine that you had filled a disk partition, 
but had plenty of room to spare on another 
disk. If you move the files over, you need 
to rewrite your programs so that they know 
where their data has gone. But if you create 
a symbolic link in the original location 
which points to the new one, everything 
will work as it did before. 


Symbolic Links are very useful, but should 
be used sparingly - otherwise you will con- 
vert your file trees into bramble bushes. 


Also available is the DOS file system. This 
allows you to mounta DOS floppy or partition 
as part of your UNIX file system. You can then 
use all the UNIX tools that you love (well, at 
least I do) to manipulate your DOS files. 


CD-ROM users will like to know that the 
High Sierra (ISO 9660) file system is sup- 
ported - I wish that I had such a drive. 


DOS under UNIX 


Here is a useful feature. If one types dos 
at the system prompt (or clicks the appro- 
priate icon on the desk top), one ends up 
with a C:\> prompt. You can now run 
your favourite DOS programs. Any printing 
will be sent (once the system has been 
properly configured) to the UNIX spooler. 
It is possible to run multiple DOS sessions 
simultaneously. 


The DOS emulation works by using the 
virtual 8086 mode of the Intel chip, and, 
unlike OS/2 or Windows, you can’t (in my 


UNIX 


History of SCO ODT 


In the mid 1980s, Microsoft brought out a version of UNIX designed to run on IBM 
PCs called *XENIX’ (for ‘Extended UNIX’). Soon afterwards it transferred its interest 
to the Santa Cruz Organisation (based, you won't be surprised to hear, in Santa Cruz, 
California), Microsoft has retained a large share holding in SCO. Xenix rapidly became 
a popular workhorse for small depattments on which they ran their accounts, 
databases etc. 


Itwas an attractively priced effective solution, partly because of the relative cheapness 
of IBM AT compatibles. XENIX wasn't glamorous, but it did get the job done. SCO 
essentially owned the PC platform based UNIX world. 


XENIX was so important that, as part of the UNIX standardisation effort, it was 
merged back into the mainstream AT&T (now USL) UNIX to make Version V.3.2. 
XENIX is still available as a small, mean system for those who don't need the features 
of full-blown UNIX. 


Meanwhile, other versions of UNIX had progressed and acquired lots of wacky new 
features, including networking (based on TCP/IP), Networked File Systems, X Win- 
dows, internationalisation features (ie the ability to talk to the user in his mother 
tongue - NLS) and more. 


SCO didn’t want to get left behind by not offering these features. SCO wanted to be 
able to compete on the desk top, ie against the emerging Microsoft Windows and 
IBM's OS/2. Additionally, XENIX didn’t really work with DOS or DOS networked 
machines. An extra pressure was introduced by the US government, which two years 
ago mandated a minimum of a DOD C2 (security level) in the software that was 
supplied to it. us 

XENIX had to be replaced, but SCO did not want to loose the large installed base. 
Three years ago, SCO introduced the first (beta) version of ODT. The recent release 
2.0 of ODT introduced many new (for SCO) features and maintained upwards 
compatibility with XENIX. 


It is worth noting that SCO ODT is release UNIX V.3.2.4, version 4 based on System V 
release 3.2, Itis not based on System V release 4 - as many people wrongly inferred from 
some SCO marketing information, Although SCO has introduced some V.4 features, it has 


a long way to go to become V.4 based, and refuses to say if it will do so, 


aes 


experience) crash UNIX from within the 
DOS box. Because it is based on virtual 
8086 mode (ie IBM XT compatible), you 
can’t use 286 or 386 features such as pro- 
tected mode, nor can you run Windows 3.1, 
However, you can access LIM 4.0 memory 
if you need it. In spite of these limitations, 
the DOS emulation is a really useful envi- 
ronment. 


Security 


To comply with the US C2 requirement for 
government contracts, SCO includes some 
extra security features not supplied with 
traditional UNIX. You can choose from four 
levels (from high to low) the degree of 
security you want. These levels are new 
with this release and were introduced be- 
cause many people didn’t want the extra 
administrative burden of the high-levels. 


Many manufacturers offer a C2 capability - 
and they all, unfortunately, implement it in 
different ways, SCO’s is licensed from Se- 


cureWare Inc and is a mixture of kernel and 
user-level code. 


Features include the ability to restrict cer- 
tain system resources such as printing, 
using su or ps and then running the set- 
userid programs or auditing (disk logging 
to you). The highest level will record every 
file open, close, program run... an excellent 
way of filling unwanted disk space. I 
switched this level on and filled 14 MB in 
five minutes. This is all well and good, but 
who is going to bother to look at it all? 


More practical measures include locking 
users out if they get their password wrong 
too many times, forcing regular password 
changes and checking passwords for ob- 
viousness. I think that ODT could do more 
in this area, but this is a start. 


XENIX support 


ODT allows you to run XENIX binaries, and 
also cross compile for XENIX systems. 
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Many ISV’s produce 286 XENIX binaries, so 
this feature will make their life much sim- 
pler. Incidentally, you can also cross com- 
pile for DOS systems. Mention of 
compilation brings us to... 


The Development System 


The Development System is a C compiler 
supplemented with a few other bits and 
pieces. Actually you get twoC compilers. The 
main compiler, cc, is the Microsoft C V6.0 
(so, as usual, UNIX remains one release be- 
hind its DOS counterpart). The alternative is 
the AT&T C compiler, available through the 
ree command. SCO also details what you 
need to do if you wish to getthe (much better) 
gec compiler working, which is part of the 
GNU public domain set of utilities, However, 
it’s down to you to get hold of gcc. 


The standard UNIX utilities make, sccs 
(Source Code Control System) and Lint a 
C program checker are all included. Time 
invested in mastering these utilities is well 
rewarded. The kit also contains lex (a 
Lexical analyser) and yacc (Yet Another 
Compiler Compiler). I use these a lot for 
generating small language compilers and 
for file conversions. 


There are four debuggers available: the 
traditional UNIX adb and sdb, dbxtra 
(which knows a bit about C++), and cv - 
Microsoft’s CodeView, which looks and 
works very much as it does in the MS-DOS 
environment. Being a UNIX traditionalist I 
still prefer adb. 


For those wishing to get into X windows, the 
minimum tools are supplied, together with 
the X libraries and Motif widget libraries that 
you need, bitmap isa is a rudimentary tool 
for creating and editing bitmap images. These 
can be used for icons, cursor shapes and 
background patterns. There are several other 
tools of the same sort. 


Documentation is plentiful - about 3,000 
pages in the X and Motif manuals. A few 
example programs are provided to get you 
started, I've played with the examples and 
made them work, but I should warn you 
this is not really something which can be 
picked up by browsing the API reference - 
there is a lot more to it than that, and a 
training course(s) would help. If you want 
to get results quickly, you will probably 
have to rely on third-party tools such as 
‘GUI Builders’. 


Although there is no bundled C++ com- 
piler, many of the header files include 
C++ compatible function declarations. 
Since these also have to work for XENIX 
they can be quite messy, but at least they 
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work and you don’t need to worry about 
the inner details. 


What’s new? 


The most visible/important changes from 
the first release of ODT two years ago are: 


@ More RAMsupported (now upto 512 MB). 
@ Configurable security levels. 


@ Symbolic links and long files names in 
the new EAFS. 


© Boot time loadable drivers (something to 
worry about if you have non standard 
devices which you need to use to install 
your system). 


© Upgrade of X from 11.3 to 11.4, and the 
inclusion of IXI X.desktop. 


@ LIM 4.0 support included, upgrade from 
DOS 3.X to DOS 5.0. 


@ Networking: enhanced networked print- 
ing with Berkely’s LPD, PPP (Pointto Point 
Protocol), SNMP included, Automounter 
daemon, and NIS. 


@ The C compiler is now ANSI compliant, 
with options for POSIX, xpg3 and svid 
compliance. Lintunderstands void poin- 
ters (at last). 


@ The Ingres Database package and related 
components are no longer bundled in 
ODT. 


Inaddition to these, various other less import- 
ant components have been upgraded - but, 
unless one had a particular compatibility 
problem with one of them, I doubt that these 
changes would be of interest. 


What you need 


To run SCO ODT you will need an 386/486 
PC with at least 8 MB of RAM and 120 MB of 
hard disk. These are the minima for the per- 
sonal system, the ODT server needs more. I 
would recommend a minimum of 16MB of 
RAM and 250 MB of disk if you intend to do 
real work on the system and use all the fea- 
tures. 


SCO works with ISA, EISA and MCA buses, but 
you should specify that if you have an MCA bus 
when you place your order, and you should 
alsosay if you havea 3.5" ora 5.25" floppy drive. 


You ought to have a QIC tape drive as well. 
UNIX systems are larger than DOS ones, and 


you will soon get bored of backing up to |. 


floppy. If you do have a QIC-24/QIC-02 drive 


UNIX 


you can get ODT on tape - much faster to 
install, and just a little bit cheaper. (If you 
have a CD-ROM, ODT is cheaper still - 
about 15%). 


If you want to attach it to a LAN you will 
need an Ethernet card. Choice of brand is 
important here; get an SCM (Western Digi- 
tal) or 3Com card, but don’t get a Novell 
NE1000/NE2000, as it won’t work (they don’t 
seem to work with TCP/IP anywhere). 


Be careful, after booting UNIX does not use 
the machine’s BIOS and so needs to be able 
to drive the hardware directly, and it pushes 
it much harder than MS-DOS ever could. 
SCO does a good job at working on most 
PC platforms, but it does suffer from hard- 
ware incompatibilities on some of them. So 
don’t buy cheap hardware, and specify that 
you will be running SCO ODT when you 
order the machine (so that you can send it 
back if it doesn’t work). If in doubt check 
in the SCO Hardware Compatibility Hand- 
book, Unfortunately this doesn’t list the offer- 
ings of many of the smaller clone 
manufacturers -not because they won’twork, 
but because they haven't been tested. 


Oh, one last thing: you will need two feet 
of shelf space for the manuals that come 
with the Personal System alone. 


Installation is quite smooth. You get asked 
a lot of questions about the hardware, and 
you have the option of installing the whole 
product or selecting parts of it. After this 
you need to set up user accounts, con- 
figure networks... 


Bottom line 


OK, what does it cost? An ODT personal 
system costs £1150, and an ODT server 
costs £2300. The personal system is essen- 
tially a two user licence, the server an un- 
limited user licence with some additional 
networking server utilities. If you want the 
development system you'll have to find an- 
other £995, and then £795 for a C++ com- 
piler. 


EXE) 


Alain Williams is a director of Parliament 
Hill Computers Ltd, a small UNIX systems 
consultancy, developer of phLOGIN’ which 
isasecure, configurable, network knowled- 
geable UNIX login tool. Alain is also the 
editor of the EurOpen newsletter, and may 
be reached on 0734 461232 or 
addw@phcomp.co.uk. 


SCO is on 0923 816344. 


Peter Collinson is on holiday. 


How many users of your software paid for it??? 


SOFTLoK International Limited was established in 
1987 with the introduction of our SOFTLoK and 
SOFTLOoK PLUS devices to combat the ever 
increasing problem of software piracy. Our 
SOFTLokK range of software protection devices are 
used by hundreds of software developers from 
small consultancies to large multinationals. To cope 
with the ever changing needs of our customers we 
have developed SOFTLoK II which combines the 
programmable features of SOFTLoK PLUS with a 
low unit cost similar to our original SOFTLoK 
product. 


SOFTLOK II” 


The Next Generati ion 


SOFTLoK II units are programmable devices 
containing read/write memory protected by a 
password. Both the memory and the password 
can be changed at any time using our routines 
in your application software. Easy to use menu- 
driven software is provided to allow small or 
large batches of SOFTLoK I! units to be 
programmed with their initial data & passwords 
ready to be sent out with the protected software 
product. 


Price: 1-19 £1 6.90, 20-49 £1 5.40, As SOFTLoK II units plug into the 
50+ £13.70 parallel printer port they can be installed 
or removed in seconds. 


Evaluation kit £20 (SOFTLoK II, manual & software) 
All prices excl. VAT and delivery 


For IBM PC, PS/2 and compatibles 

Uses parallel printer port 

Totally transparent to printer 

Secure data & password can be changed from your application software 
Cascadeable 

240 bytes of secure read/write memory 

8 byte (64 bit) password 

No programming adaptors required 

Easy to use SOFTLoK II setup software 
Routines ready to link with various compilers 
Easy to follow manual 


Ooooocooococa 


I-MEX House, 40 Princess Street, 
Manchester, M1 6DE, England, 
Tel: 061 228 7379 Fax: 061 236 6890 


> CIRCLE NO. 412 


Not necessarily OOP 


Discussion of OO and C++ seem naturally to go together. 
Mike Banaban points out that they aren't always the same thing. 


Whenever you get amongst a group of 
those hairy-handed sons and daughters of 
toil, the hardened C++ users, conversation 
has a knack of moving around to the same 
old question. Then, when you've finally 
worked out who did have the goat vindaloo 
and extra chapattis, the second most popu- 
lar argument gets started up. It goes along 
the lines of this hairy old joke: 


: How many people work in your office? 
A: Oh, about half of them. 


The C++ port of this joke is: 


Q: Of all the people who've bought a C++ 
compiler, how many are actually using C++? 
A: ****ed if know mate, but not many ofthem 
if the bug reports are anything to go by. 


That last answer is copyright © 1992 to the 
C++ product manager of a major compiler 
vendor who would kill me if] mentioned his 
name. (He had the extra chapattis too). 

There’s a lot of truth in it. C++ offers the 
kind of type-checking that even an ANSI C 
compiler is unable to provide unless it 
chooses not to conform to the Standard and 
throw away the backwards compatibility 
that the committee spent hundreds of hours 
carefully tailoring in. That alone is a worth- 
while improvement. Throw in a few simple 
concrete classes like Strings and Associative 
Arrays, with the relevant bits of operator over- 
oading, and you've already started working 
in a new world compared to Old C. 


The subjective quality of the software 
changes enormously. Robustness creeps in, 
ofa kind that C programmers just aren’t used 
to. Instead of the program crashing (on DOS 
the machine hangs, under UNIX you get a 
core dump) it carries on running and you can 
as often as not see from the output what is 
wrong with it. This more graceful kind of bug 
is appreciated by the users too - they don’t 
actually rush out and thank you, but the foul 
language is more muted. 

C++ and a few concrete types is un- 
doubtedly a worthwhile improvement on 
C. If you want to crank out some rough- 
and-ready programs for Windows, then 
most of the PC compiler vendors provide a 
get-you-started class library which serious- 
ly reduces the time it takes to get a simple 
application ‘going. This is all stuff worth 
having. However, it leads us on to the third 
question: How many of the people actually 
using C++ are doing Object Oriented Pro- 
gramming? 

From what I’ve seen so far, I’d venture 
that the answer would be a very small num- 
ber, Of course, we could argue about what 
OOP really is, but if you read the back- 
ground literature, there’s a consensus ol 
sorts starting to emerge. We'll have to as- 
sume that OOP embraces Object Oriented 
Designs too: we're talking about software 
systems which do more than play around 
with a few unrelated user-defined types (or 
Abstract Data Types if you want to use a 
posh term). Instead, we need to look at the 
purpose of inheritance and polymorphism. 


class String 
{ 
// private stuff 
public: 
String(const char *); 
virtual ~String(); 
virtual size_t Length(); 
String &operator =(const String&); 
friend String operator +(const String &, 
yi 
class FontString: public String 
{ 
// more private stuff, including storage 
// of font information, which we trick a 
7/ String into doing for us 
String fonts; 
public: 
FontString(const char *, int pointsize); 
FontString goperator = 
(const FontString &); 
friend FontString operator + 
(const FontString&, const FontString&); 
ve 


const String &); 


Figure 1 - String and FontString classes 
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// include relevant headers 
void do _good_stuff (String @rl, String &xr2 


// wots of clever things, then 
rl = r2; 


main() 

( 
FontString fs1(" 
String sl = ".E 
do_good_stuff (£ 

} 


Figure 2 - A deliberate mistake 


Many, many users of C++ appear to 
misuse inheritance because of a fundamen- 
tal misunderstanding of its purpose. This is 
not surprising, because it’s hard to find 
many descriptions of how to do it right. 
Inheritance is often wilfully (or it might be 
through ignorance) presented as a tool for 
code reuse. It’s perniciously easy to swal- 
low the message and to use it in that way, 
although there’s increasing evidence of the 
damage that results to your software struc- 
ture as a consequence. 

Figure 1 contains an example of reuse- 
driven inheritance giving us some nasty 
results, Assume we've got a class String 
(you've probably got something suitable 
lying around somewhere). You want to 
implement an augmented version, say for a 
word processor, which supports font infor- 
mation too. Noticing that you've already got 
String, you decide to use it as the basis 
for Font St ring (after patching up the 
important member functions to be virtual). 

Now, since they are related, we can use a 
pointer or reference toa Font St ring any- 
where we can use a pointer or reference to a 
String, can't we? After, all that’s the whole 
point of inheritance isn’t it? Well, take a peek 
at Figure 2 and tell me what happens. 

Got it? It’s just that (but, to paraphrase 
the Rev Awdry’s ‘Toby the Tram Engine’, I 
cannot tellyou any more, or [shall spoil the 
next column.) 


EXE! 


Mike Banaban is chairman of the Euro- 
pean C++ User Group, and may be emailed 
asmikeb@hoskyns.co.uk. For more 
information about ECUG membership, 
please call 071 253 5121. 
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“You only need to buy one copy! They don’t protect with DESkey.” 


DESkey — Software Protection from the 
inventors of the intelligent Dongle. 


We have more experience and expertise in the design of 
software protection modules (dongles) than any other 
company in the UK. We sell products designed in house by 
our own engineers. More than |3 years experience in the 
design of dongles have gone into our current product 
range. 


@ DESlock® automatic.EXE or.COM file encryption system. No 
need for source or.OB| files. Takes only a few seconds to protect 
your software —now available for OS/2 and Windows. 

@ 'Seedable’ Pseudo Random Number Generator: 
Software and data encryption could not be more secure. 
@ Through Encryption. Data can be fed into the 
DESkey for on-line encryption. This keeps the 
encryption key hidden. 

@ Memory. Up to 240 bytes of memory split 
into ‘Public’ and ‘Private’ sectors. The ‘Public’ 
sector may be read from and written to at 
will. The ‘Private’ sector may be read at will, 

but writing requires your customer specific 
password, 

@ Down Counter. You program into the 


DESkey the number of times the program will run before stopping. 
This gives you the ability to sell ‘goes’ of your software rather than 
an open licence to use It forever—or even to send a fully working 
demonstration copy that will stop working after say, 10 goes. 
@ Variable Response Algorithm. This feature is similar to the well 
known ‘public-key’ algorithm and works in conjunction with an 
algorithm on the host computer. Makes any attempt at software 
emulation impossible. 
@ Secure Memory Read, Even ifthe same memory data is read 
repeatedly, the data retumed from the DESkey never appears the 
same —this also makes the DESkey impossible to emulate. 

@ Parallel, Serial or Bus versions available. 
@ Intelligent Serial devices suitable for any operating 
system such as Unix, Xenix, OS/2, DOS etc. 
Works on any hardware including PC 
Networks, Mini Systems oreven 
Mainframes. 
@ Free evaiuation Kits. 
@ Guaranteed Exclusivity to all our 
customers. 
@ Fast Order Turn-round. 
@ Sold only through Data Encryption 
Systems Limited. 


Edbrook House, FAST 
Cannington, Bridgwater, 

Somerset, TAS 2QE Fegan vets 
Telephone 0278 653456 : Ne Data Encryption Systems 
Fax 0278 653300 Data Encryption Systems Limited isamember of FAST 


> CIRCLE NO. 413 


Some C Traps 


Francis Glassborow offers four C traps which are worth avoiding. 


Implementation Details. | recently needed 
to make an alteration to an old, stable program 
of mine. I needed the new version quickly and I 
had discarded the original compiler. Finding 
space to re-install it would mean a major re- 
shuffle. So I chose to use another compiler. 
Thereby hangs an instructional tale, 

The original source was reasonably portable 
between compilers (or so] thought) as it had been 
developed on one compiler then reworked on a 
second froma completely different supplier. 

I replaced the project file with an equivalent 
and set the compiler to work. Everything com- 
piled first time with no significant warnings. I ran 
the result. Half the information on the screen was 
missing. To be precise, all text information writ- 
ten to a graphics screen was missing. 

I remembered having problems when I de- 
veloped the program. I checked the library refer- 
ences forboth the current compilerand the origina 
ones. All three gave identical specifications for 
functions handling text on a graphics screen, 

Two hours later I managed to crack it. For 
some reason, I had written my own direct call to 
DOS to set the graphics mode. The origina 


compilers were entirely happy with this. So was 
the new one except that, by dloing so, I had failed 
to initialise a st ruct containing screen informa- 
tion that all the other screen handling functions 
were using, Using the appropriate library function 
to set the graphics mode fixed the problem. 

The moral of the story is that you need to 
know more abouta function than just its parame- 
ters and return values. Sometimes you need to 
know something about the way it is working. 

Alternatives to scanf() . Most C pro- 
grammers learn to avoid scanéf () and replace 
it by some form of input function over which 
they have more control. However a large propor- 
tion (and I must confess that includes me at 
times) use a replacement that includes a call to 
gets (). This function was included in the 
standard for one and only one reason, to avoid 
breaking millions of lines of code. 

The use of get's () ina program is an excel- 
lent way of placing a potential disaster in your 
work. There is no way that you can control the 
length of the input when using gets () . If some 
user manages to type in a line longer than your 
provided input buffer, your program is broken. The 


results may, or may not, be harmless. 

If you are still using gets () , check out the 
definition of fgets (). 1 think you will find it 
meets your needs. 

NULL pointer assignments. Are you one of 
those programmers who think the best way to 
handle a ‘NULL pointer assignment’ message 
when your program ends is to patch the com- 
piler to remove the message? If you are, I suggest 
that you never recompile your work for large 
models. The warning will almost certainly go, 
but you will be writing over DOS instead. 

And Finally, What is the potential problem 
with this little macro for swapping two ints? 


#define swap(a,b) ((a)*=(b);\ 
(b)*=(a)7 (a) *=(b)7) 
Even if a and b are always simple variables, 
there is still a little nasty hiding away. 


EXE 


s: individual £12, student £6, corpor- 
: further information about CUG(UK) 
write to Francis Glassborow at 64 Southfield Road, 
Oxford, OX4 LPA or ring 0865 246490. 


COBOLic governors (7) 
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B 19 


26 — Worked out worth (9) 
27 Hanks of hair (7) 


a i 
Senet 
Gee #8 


28 — Element of the valley (7) 


DOWN 


Good person spoke to God and broadcast indiscriminately (7) 
21 — Cutting the pressure down (9) 

23 — Wipe out age of Home Counties (5) 

25 Bones from St Paul? Nasty! (5) 


Overcome what's almost true and get data (7) 
It’s in the logical table and Pliny's wine (5) 
Tough going with US work and notes of debt (9) 


2 
3 
8 9 i 
4 Plotted on a grid (7) 
5 ts 2gives 0001 (3,4) 
br 2 5 7 —— 6 Data stores for circular 
arguments? (5) 
| 7 Someone so insignificant 
bs = is = s/he has no record (9) 
8 Thousand almost issued 
& i but badly employed (7) 
by 5 14 Needed if something's 3 (9) 
16 Does such motion result 
from an endless loop? (9) 
ACROSS 


1 American directory? (7) 
5 Like BASIC or COBOL initially (7) 


9 Market to directorate flexible old hard wiring system (9) 


10 People who dress up to them (5) 


41 Victorian teacher coming from the bush erratically (5) 


12 Radiators for chips (9) 
13 That's the puzzle for now! (7) 
15 Erased the data from store (7) 
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‘EXEWORD’ compiled 
by Eric Deeson 


17 Gone wrong? Criminal! (7) 
18 Hangs around with 
confused toilers (7) 
19 — Units of information-carrying 
energy (7) 
Place for shepherdesses 
in the East before (7) 


Melts to cut current (5) 
4 — Greek in programmer's 


Sgarret (5) 


ERB 
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When you look inside... 


You'll see that it's a real 
pearl of an idea. 


We think you should know exactly what you're friendly utilities make it a snap to develop the 
buying. That's why we've made sure you can ak scheme that's j just right for your product. And 
inside DeadLock 3. Hy ; DeadLock 3 is so secure, we're even 

DeadLock 3 gives you the best software ready to give you the complete sources*. 
protection available. Our unique Contact us today and find out about 
combination of custom-designed ASIC DeadLock 3. We've got a demo kit 
and proven mathematical algorithm lets waiting for you - complete with utilities, 
us safeguard your product without hiding samples and full documentation. There's 
anything, And that means you stay in R absolutely no obligation. We just want 
complete control.DeadLock 3 protection _ you to look inside and see what a pearl 
is dead easy to implement too. Our user- of an idea it is. 


Deadlocle 3° is real protection 


BL Computer Security Limited 
101 Hendon Lane, Finchley, vende N3 3SH 
PO Box 2543, London N3 3UA, United Kingdom 
Fax: 081 346 2672 Tel: 081 343 0734 


*Sources available in compliance with terms specified by the manufacturer 


> CIRCLE NO. 414 


CREATIVE COMMUNICATIONS 


Books 


Books 


‘Be afraid. Be very afraid.’ From the palate of one famous billionaire 
to the untimely demise of the American programmer. 


He eats pizza 


In the software industry there is one name 
that seems to crop up time and time again - 
Bill Gates. Hard Drive by James Wallace and 
Jim Erickson of the Seattle Post Intelligenceris 
not just another hagiography of the man; 
along with the fairy-tale success of Microsoft, 
it exposes the darker, more sinister side to the 
Gates character; his motivation, his relentless 
drive for World domination of the software 
industry, and the ruthlessness of his approach. 

Wallace and Erickson paint a picture of Gates as a man, born into 
an affluent, Seattle family, who got more than his fair share of lucky 
breaks. Indeed, years before the PC was a glimmer in the eyes of the 
suits at IBM Boca Raton, Gates was striking his first business deal at 
Lakeside Prep School. Lakeside was where he first met MS co-founder 
Paul Allen and it was here that he began his love affair with computers. 

Testimony to Microsoft's lucky streak is the 10 year marriage to IBM. 
Had it not been for Gary Kildall of Digital Research ‘flunking the deal 
of the century’, IBM would never have asked Microsoft to write DOS. 
There’s more. Microsoft didn’t have to spend vast resources on writing 
the operating system either - a small Seattle-based company called 
Seattle Computer Products had already written 86-QDOS, an 8086 port 
of Digital Research’s CP/M operating system. Gates just happened to 
be in the right place at the right time. By first licensing the operating 
system, and later buying it outright, Microsoft paved the way to its 
$200 million a year income from sales of MS-DOS alone. Also, 
Presentation Manager didn’t appear by magic, but because IBM 
desperately needed a GUI for OS/2, and Microsoft had one to offer. 
Gates held all the cards. Microsoft continued development of Win- 
dows along with OS/2; but when Windows started selling, Gates 
dropped OS/2 and divorced IBM. 

Luck wasn'tthe whole story. Gates had vision; a vision of Microsoft 
software on every desktop. He extracted every ounce of energy from 
his employees to reach this end. He bullied business partners with 
what Wallace and Erickson refer to as ‘intellectual brow-beating’ to 
get his way. An example: in 1985 he forced John Sculley of Apple to 
abandon Apple’s MacBasic project in favour of MS-BASIC, by 
threatening not to renegotiate the MS-BASIC licence for the Apple Il, 
atthat time Apple’s most popular computer. Many observers believed 
that MacBasic was the better product. 

With an appetite for pizza and hamburgers, and the dishevelled 
appearance of a skinny 17 year old with greasy hair and dandruff, 
Gates has more in common with a nerdy programmer than the CEO 
of the most powerful software company in the world. Hard Drive 
gives a fascinating insight into William Henry Gates III, one of the 
richest men in America, and how he got there. 


Bill Gates 


and the 
Making 
of the 
Microsoft, 
Empire 
JAMES WALLACE & JIM ERICKSON 
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Decline & Fall of Yourdon 


Before settling down to write The Decline And Fall of The Ameri- 
can Programmer, Ed Yourdon courted the opinions of a few 
American Programmers via electronic mail. Not all of them were 
happy to be labelled as dodos. Yourdon’s book must be unique 
among software engineering publications in giving major criticisms 
of its tenets before it explains what those tenets are. Whatever 
Yourdon says in the next 300 pages, you know by page eleven that 
Irv Wendel of Oakland thinks that it’s partly (quote) ‘bullshit’. 

The reason for such vigorous language? Well, this time Yourdon 
is out to scare. The most worrying aspect about Western software, 
managers, he says, is that they aren’t worried at all. They think 
they're doing okay. And Yourdon isn’t put out when his drinking 
partners point out that they are doing okay: 

“Tom DeMarco shared a panel with me in Singapore, and con- 
fronted me with a blunt question. "If the American programmer is 
in such peril, why is the US share of the world software market 
increasing?" Ummm...err...ahhh. I had no answer.’ 

Despite his candour, Yourdon is largely unconcerned by the lack 
of statistics to back his scenario of Doom. It’s true that the develo- 
ping countries which he points to as the new champions of 
programming are currently behind the States, technically and organi- 
sationally. His own appendix describing a visit to India, although full 
of fascinating insights, tacitly confirms this. The difference is that the 
managers there know they must improve. The Americans - and by 
extension, those of us in the 51st state too - do not. 


If Weenies ruled the Earth 

One of the chapters of Decline is dedicated to a quick survey of 
CASE tools, At one point, he charts the movements in CASE in the last 
ten years; Yourdon-DeMarco and Constantine versus Martin, Bach- 
man, Chen et al. The premise is that the information engineering and 
SA methodologies are evolving towards a middle-ground, that com- 
bines both data (which Martin is hot on) and function (which the older 
CASE systems concentrated upon). The diagram which he uses to 
illustrate this point lists the IE folk as CEOs (company chairmen); 
Yourdon and co are listed as ‘Tech Weenies’. 

While it may come as some surprise to junior developers to 
discover the man who makes them spend hours on those fiddly 
little hand-drawn design diagrams actually sees himself as one of 
them, Yourdon does spend a lot of time talking to programmers. 

He also believes that many managers do not. One of Yourdon’s 
most fascinating chapters came about after he posted a message 
onto one of CompuServe’s electronic bulletin boards. Ina nutshell, 
it asked programmers what they would say to their managers if 
they weren't scared of getting sacked. He prefaces it: 

‘Read this chapter as if it were a memo from one of those 
programmers whose name you can’tremember, whose scruffy face 
you see only at Christmas parties and other ceremonial gatherings.’ 

Yourdon’s purpose isn’t just to grab back some hacker credi- 
bility. One of the statistics which he and his opposition do agree 


on is that a very good programmer can transform any company’s 
production statistics, regardless of tools, techniques, and pro- 
gramming environments, He quotes Sackman, Erikson and Grant’s 
1968 study of twelve programmers, each given the same exercise, 
The best person in the group finished coding and debugging the 
exercise 28 times faster than the worst, and the best program was 
approximately 10 times more efficient (in terms of memory and 
CPU cycles) than the worst. 

Yeah, yeah. We've heard this before. What is interesting about 
Yourdon’s survey, however, is the number of positive ideas that 
float away from the core of general griping. Yourdon lists them, 
because he feels that one of the main problems with US companies 
is that the turnover of good programmers is far too high. Losing 
programmers, he says, is more of a pain. In a high-turnover firm: 

‘the best people quit, the worst people are fired, and what you’re 
left with is all the mediocre people in the middle. [Also] the workers 
at the bottom of the organisation are typically very junior, often 
with no more than 6 to 12 months of experience.’ 

Yourdon and his survey come up with some solutions. In the 
workplace, one of the biggest gripe about managers is their slip- 
periness in ‘Doomed Project Scenarios’. Managers have an obliga- 
tion to motivate; but this often means barefaced untruths when a 
project is clearly heading for disaster. And as one correspondent 
says: ‘People in doomed projects know they are doomed fairly 
early on. They just never tell their bosses because they assume 
that’s a waste of time (frequently a true assumption)’. 

It’s hard to provide solutions for these Catch-22 situations but 
Yourdon does suggest - and for the sake of brevity, I may be stating 
his case more strongly than he’d like here - that saving one’s 
credibility in front of valued programmers (and thus keeping them 
for longer) is better than sacrificing one’s reputation on an im- 
possible project. It also has the ad- 
vantage of encouraging honesty 
along the entire command line. Ad- 
mitting a assignment is up a wrong 
tree to your programmers - or listen- 
ing when they tell you it is - also 
entails telling your boss, too. Praise 
was universal for managers who ‘told 
it how it was’ - up or down the chain. 

Dumping bad programmers was 
another unusual demand. Of course, 


Books 


Not, he adds, that departing employees are the enemy. On the 
contrary, exit interviews with programmers can often clear the airenough 
to make them your friends. Friends you don’t have to pay, too. 


The road is long... 


‘The majority of software development organisations today are 
far too primitive to take advantage of CASE, new methodologies, 
or virtually any complex technology,’ 

Another pessimistic view? If it is, then Yourdon is in good 
company. It comes from his overview chapter of a fundamental 
principle in Decline, described as the ‘hottest’ idea in the software 
development industry these days: organisational maturity. Watts 
Humphrey’s work on the long-term evolution of DP companies 
suggests that it can take as long as a decade for a stable DP 
department to grow wise enough to use - and understand its use - 
of CASE, quality assurance and software metrics. 

If Decline is beginning to sound like a jeremiad, broadcasting 
doom for any company with less than epoch-sized long-term plans 
- well, ina way, itis. The key point that Yourdon states and restates 
is that software managers, if they want to survive in the 21st 
century, should start planning now. This doesn’t mean forgetting 
the next week’s project deadline, but seeing it as a step to moving 
the rest of the company onto the next step of its organisational 
maturity. The length of time to reach full maturity should not be a 
worry: it should be a relief. After all, the only company that has 
provably reached full maturity so far is NASA. 

There aren't a great deal of fully illustrated solutions in Decline, 
It’s not that sort of book. However, like the man in the AA advert, 
if Yourdon doesn’t know how to get out of every mess, he knows 
some men who do. The final, and perhaps most useful chapter, of 
Decline lists Yourdon’s suggested reading: some eighty-seven 
books that describe why Yourdon is 
taking the stand that he is. 

Decline and Fallis an entertaining, 
readable book; attributes it appears 
to have taken to be backwardly com- 
patible with the publications that 
Yourdon lists. It also, consciously, 
sticks its neck out. You may not agree 
with everything it says - I must admit 
to giggling when Yourdon cited the 
Alvey Directorate as something those 


allof Yourdon’s sample felt that they Looking wily foreigners had up their sleeves 
were not the programmers in ques- to destroy the State’s supremacy. And 
tion here, but most agreed that sack- Goob ul I, for one, couldn’t stand to read 
ing a poor programmer had a greater FEELIN G Robert M. Pirsig’s ‘Zen and the Art of 


effect on productivity than hiring a 
good one. It’s also, they added, a lot 
easier. 

But if programmers were happy to 
see themselves culled, they had to 
some reservations about how it is cur- 
rently done. The introduction of Exit 
interviews was widely praised. Your- 
don admits: 

‘Any manager who has participated 
in exit interviews will tell you that it’s 
frustrating, annoying and discouraging 


Motorcycle Maintenance’ again (all 
Chautauqua and no action). None- 
theless, Decline and Fall’s attitude 
and lucidity recommend it. It’s also 
scarier, in parts, than most horror 
books. Dan O’Brien 
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PERSONAL IRIS 4D/20,25, 
1Mb £44.00 
4Mb £165.00 
PROFESSIONAL IRIS 4D/50,70,80,85 
1Mb £44.00 
4Mb_— £165.00 


POWER SERIES 4D/120,210,220,240,280, 
310,320,340,380 2Mb_— £135.00 


NEXT COMPATIBLE MEMORY 
NEXTcube,NEXTstation IMb £42.00. 
4Mb_~ £170.00 


SABREBANNER 
Tel 0532 854521 


VISA, Access & MasterCard Taken 
Fax 0532 853026 
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CONTRACT OPPORTUNITIES 
— WINDOWS, DOS, UNIX 


Call us NOW: Freelance programmers with 
experience of WINDOWS, Client-Server 
technology, GUI-Unix tools, C/C++, 
LAN/multi-user systems development. 


Considering contracting? 
Call us first. 


CALL LEENA MEHTA: 
071-922 8819 @arioursy. 
(071 922 8839 — 


HE} 
RICHFORDS SOUTH BANK TECHNOPARK 
ROAD LONDON SE1 6LN 
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the soft corporation 


Specialists in the recruitment of relational database personnel 


c/c++/unix/ms/dos 

Soltwaro Houses and End Users in Finance, Banking, Manufacturing, Commorcial, Scientific and 
Government application environments require oxcollont C skills, Both Windows dovolopment skills 
W/, SDK, X-Windows and visual basic or strong C, C++, solid oporating systoms and good 
applications knowladgo aro again much in domand. Software davolopmont axporionco is the Koy, and 
boing ablo to doliver high performanco, high quality, wall spoctiad software in compotitve timoscalos, 
Opportunitios vary from small to largo software companies involved in oxport systems, GUI's, Imago 
Processing, GIS, EIS, Communications, Notworking and Object Oriented databases, Graduates 
through to senior software enginoors/Team Leaders are required. 


£14,000 - £35,000 rot SC/2/.0x0 


software developers windows/c/c++ design 

Our cliont companies require candidates with the following skills: Tochnical Software Development, 
Software Enginooring, Pro/Post Salas, Database Design and System Consultancy. 

‘Aroas of particular intorest includo: Distributed Systems, Object-Oriented Databases, LAN's, WAN's, 
Graphics, Image Processing, Windows, PC database products (Clipper, Paradox, Foxpro), Formal 
Dosign Mothodologios, CASE tools, Export Systoms, Knowledge Enginooring, Otfico Automation, 
Compilors, Low-Lovol dosign, Data Intogration and varied application dosign, Ploaso cal to discuss 
your particular ekils 


£12,000 - £40,000 


relational database skills - all levels 

Wo are currently recruiting for software professionals with tachnical exporise in the following areas: 
UNIFACE, SYBASE, INGRES (VS or 6), ORACLE V.6, 6.3, 6.4, INFORMIX, RDB, SUPERBASE. 
‘Additional experiance of: SQL, FORMS REPORT WRITER, C & other 3GL languages are also of 
interest. 

Wo currently have client companios including Management Consultancies, Systems Houses, Systems 
Vondars, Bank and Finance. Clients are looking for candidates with: 

Relational Database Design, Database tuning, Systems Administration, DBA’s, Pre/Post Sales and 
solid programming expertise and knowledge, Please call to discuss your particular requirements. 


£18,000 - £40,000 + benefits rof SC/26/.0xe 


unlface programmers 

‘A city-basod cliont requires 10 young motivated professionals with at least 6 months experience of 

UNIFACE programming, Initially linked to a VMS/RDB database but plans aro boing made for a swift 

move to a Sybase development platform under UNIX. As thoir skils aro at a promium, the company 

will pay good programmers an excellant remuneration package to £30,000 regardless of ago. Time to 
_slep up your career and salary prospects. Call to discuss other Uniface opportunitios. 


£20,000 - £30,000 + benefits 


software engineers - senlor software engineers 

Clionts-End-usors, Software Vendors and Software Houses dedicated to strategic implementation of 
leading edge technology and integration of applications across differont hardware and operating 
system platforms require candidates to degree level with a scientificitechnical development bias and 
1-3 yoars experience, There are two main options:- TECHNICAL DEVELOPMENT: Continued use of 
UNIX, VMS, MS/DOS, C, Windows, Networking and Communications with companios offering 
technology based careers and managoment responsibilty. 

COMMERCIAL DEVELOPMENT: Using technical skills already dovoloped, but offering opportunitios 
to apply analysis and design skills rathor than romain a ‘technical guru' in various environments 
including finance, Please call to discuss your particular caroor potontial, growth and potential. 


£15,000 - £30,000 + benefits rot: SC/3/.0xe 


sybase/uniface/microsoft sql server 

Excollont romunoration for quality candidates with at least 6 months UNIFACE or Syase/Microsoft 
SAL sorver and good communication skills, opportunities from Analyst Programmer/Databaso 
Designers to Sonior Consultants. 


£17,000 - 40,000 + benefits 


Ingres v.6 + support/development 

Candidates with rocont Ingres experiance aro in groat damand, Positions aro variod from Product 
Design in financial environment to Senior Analyst Programmors and Programmers. Knowladgo of 
Ingros Star, Windows 4GL, Ingres ABF and structured methods experience an added bonus. 


£18,000 - £40,000 Ref SC/20/exe 


unlx/alx support/development 

Candidates with UNIX/AIX oxporionce in a database environment ullising SQL, 4GL’s or C aro 
required in a number of different industries and locations. Exporiance to Systems call level is proferod 
but clients aro floxible dependent on other relevent skills, Please call to discuss. 


ref SC/1/.exe 


ref: SC/26/.exe 


Ref SC/27/exe 


£22,000 - £35,000 Rof SC/28/oxe 
STOP PRESS 
© INGRES CONTRACTORS - IMM - CITY/MIDLANDS X 20 VARIOUS LEVELS Ref 35 
RACLE TEAM LEADER, FORM3 - SW HOUSE NORTH - WEST Rol 36 
INGRES - ANAUPROG - 12 MONTHS INGRES V6 LIVERPOOL Rof 31 
INGRES V6 SUPPORT + MAINTENANCE, 
MGR + SUPPORT CON - SURREY/HANTS Rot 32 
© ORACLE V.6 SQL FORMS, SSADM, C, CASE - BERUS/SURREY Rof 33 
INGRES V.6-V.6 - Financial Systems Consultant City - £30k + Car Rof 34 
INGRES Development staff - All lovels - various locations to £35k Rot 35 
UNIFACE PROGS - CITY/FINANCIAL - TO £30,000 + Benofits Rot 36 
UNIFACE - ALL LEVELS - PROGRAMMERS TO DESIGNERS - Herts £40,000 Rot 37 
SYBASE ANALYST/PROGRAMMERS - FINANCIAL - CITY - £25,000 + BB Rof 38 
INGRES undor VMS/UNIX, Window 4GL - Various - Salary £30,000 + Rot 30 
UNIX SYSTEMS ENGINEER - INGRES/ORACLE - SURREY £30,000 + Ref 40 
UNI/AIX SYSTEMS ENGINEER - UNIX, R516000, Databaso Surrey/Horts £25,000 + Rot 41 
INFORMIX - Support - Accounting Packages - £22,000 + Car Middx Rof 42 
INGRES Financial Systems - Midlands - £30,000 ; Ref 43 
©, MS, DOS, Windows. FINANCIAL SYSTEMS - CITY - £20 - 30,000 Rot 4 
UNIX/G Autocad X 3 Software Engineers - Barks - £25,000 Rot 5 
UNIW/AIX PRE-POST SALES - ALL LEVELS LON/MANCHESTER - £30,000 Rot 6 
UNIX/C,C-++, X-Windows - Office Automation - Horts - £25,000 Rot 7 
UNIX/C++ ESPRIT Project CAD/CAM - SUR-BERKS - £25,000 Roof 8 
SofVENG GRAD 2 Years + C or C++, UNIX, Sun0S Open Windows, 
SYBASE/INCRES - C London - Trading Systems - £25,000 + Rot 9 
© UNIX/VMS FIELD SERVICES ENGINEERS - £15,000 - £25,000 Rof 10 
© PRE/POST SALES UNIX/AIX - manufacturer - Surrey £30,000 Rof 11 
© PC Dosign Consultants - Borks/Surrey £30,000 + Rot 12 
© X-Windows Dovolopment - Various London/S-E £30,000 Rot 13 


© Systams Programmer - OSI2 (Systoms lavol), C, to £14,500 Midlands 

© Windows/UNIX support (some dovt) - strong UNIX, C, +X. (Tools + Lib level) £18 - £21,000 Cambs 
+N. Bucks 

© Technical Support - good UNIX req, prof VMS or DOS - ¢£18,000 Surrey 

© Systems programmer - Compiler Devt. - strong OS/2 +'C’, pref COBOL £18-£25,000 Barks 

© UNIX Consultancy/Support - Kernel level problems, pref. Comms. to £35,000 Hants 

© Tech Support - Sourca Code env. - UNIX to Kemal/Device Driver lovol Italian or German ess. 
£26,000 Herts 

© Systoms Progs - Grad + min 2 yrs C/UNIX, Assembler/Comms useful European Travel 821k Middx 

© Programmer - c2 yrs C/UNIX, 1 yr + X-Windows c£18,000 Avon 


the soft corporation 
10 Pakeman Street, London N7 6QN 
Tel: 071-609 5501 Fax: 071-700 5787 


ANSI and 
ISO Standard C 


Windows SDK 


Microsoft C 
v.5.1.— 6.0 


0S/2 Presentation 
Manager 


Borland, Zortech 
or Turbo C 


DDE, DLL or OLE 
MS-Quick C or Sycero C 
OOD and OOPs 


All Unix 
manufacturers’ C 


Microsoft C/C++ v.7.0 
Pro* C 


Borland, Zortech 
or Turbo C++ 


NeXT Step/Objective C 


Visual Basic or 
Smalitalk/V 


X-Windows or 
OSF/Motif 


Powerbuilder or Easel 
OpenLook or Sun View 


SQLWindows 
or SQLBase 


Sybase or SQLServer 


SQL or Embedded SQL 


-EXE RECRUITMENT ADVERTISING - Call Marc Warren on 081 994 6477 i 


‘Cc 
DEVELOPERS 
PCs & UNIX 


LONDON/SOUTH EAST 


PERMANENT 
£15 - 35,000 PA 


For further 
information on 
how to put your 
career in the fast 
lane, please 
contact Conrad 
Hills, quoting 
reference PCEX16, 
on 071-734 4010 
(office hours) or 
081-542 8724 
(evenings/ 
weekends). 


CONTRACT 
£800 - 1,400 PW 


Alternatively, write 
to him at 
McGregor Boyall, 
Sutherland House, 
5-6 Argyll Street, 
London W1V 1AD 
or fax your CV on 
071-734 1297. 


McGregor Boyall is the UK’s leading PC & Unix 
specialist recruitment consultancy, with a long 
and successful track record of placing candidates 
with backgrounds in ‘C’ development on DOS, 
Windows, OS/2 and Unix platforms. We have, 
consequently, built strong working relationships 
with a range of clients, including software 
houses, consultancies, merchant banks and other 


large end-users. 


Due to the Client/server ‘revolution’ and the 
continuing implementation of Unix-based open 
systems, candidates with development 
experience gained with ‘C’ have never been in 
higher demand. If you have knowledge of, or 
exposure to, any of the skills listed opposite, then 
there are a wide variety of exciting opportunities 


currently awaiting you. 


mcgregor 
boyall 


IT HUMAN RESOURCING 


EXE RECRUITMENT ADVERTISING - Call Marc Warren on 081 994 6477 | 


ASH ASSOCIATES 


We specialise in the recruitment of Software and Hardware Design Engineers for 
Real Time Applications including Computer Graphics, Communications, controland 
Robotics, Signal and Image Processing, Mathematical Modelling, Real Time 
Financial Systems and Databases. 


SOFTWARE TEST IN DEMAND 


SOUTHEAST to £22K 
These High Technology companies seek highly motivated software design 
engineers at all levels with varied and broad experience to design software 
test/de-bugging systems for a wide range of Software and Hardware 
Systems/Products. 

Applications include Video and Graphics Systems, Broadcasting, Software 
Products/Packages and even Operating Systems Development. 

You will be using the latest and most popular (IN DEMAND) software tools including 
C, Windows, DOS, UNIX, VAX/VMS and Intel/Motorola device driver development. 


WE HAVE REAL OPPORTUNITIES FOR ENGINEERS 
WITH ANY OF THE FOLLOWING SKILLS 


nts: WiNDOWs | [unix fi 00s | 
=5760 
raseat[octan [verwonks rn 
INTERFACING/PORTING |) 0S9 | 


For these and similar opportunttles call James Hunt or Ron Cook NOW! 
Tel: (0425) 47580 Fax: (0425) 480807 


[ASH ) associates 


RECRUITMENT CONSULTANTS 
3 Plper’s Ash, Ringwood, Hants, BH24 1UF 


WEST 
YORKSHIRE 


Programmers (particularly ‘C’, 
‘C++’, COBOL and 4GLs under 
UNIX or Windows, Analyst 
Programmers, Software 
Engineers, Project Leaders, 
Support (pre and post sales), 
Trainers. Also Hardware/Software 

Design Engineers. 


FOR YOUR NEXT CAREER MOVE 
AROUND WEST YORKSHIRE 


Telephone Vincent Atherton on Leeds 
(0532) 504560 or write to: 


AIREDALE RECRUITMENT 


Realtex House, Micklefield Lane, 
Rawdon, Leeds LS19 6AX 


AIREDALE 
RECRUITMENT 


THE 'C’ C++ WINDOWS SPECIALISTS 


C++, OOP, UNIX 
City to £25,000 
Our client ts a leading total solution provider of 
Trading/Dealing Room Systems dealing 
worldwide in the FinanciaVSecurities industry. 
Due to expansion they currently seek graduates 
with at least two years commercial 
using C++ and/or 'C’ & UNIX (preferably SUNos). 
Knowledge of Open Windows, Motif & 4GL's 
would prove to be a distinct advantage but an 
ambition to succeed 1s a must in this young and 
dynamic environment. 


FINANCIAL ‘C’ & 
WINDOWS 3.0 

City £22-30,000 
Our client is a major worldwide supplier of 
financial data and fund management data to the 
securities industry together with the software to 
analyse and manipulate that data. they requtre:- 
Analyst Programmers to join existing teams 
developing financial applications. Candidates 
must be educated to degree level with four years 
commercial programming experience using 
‘C/C++ for at least two years and WINDOWS 3.0 
and/or SDK on DOS. Expertence of UNIX, 
ASSEMBLER, OS/2 and STRUCTURED 
METHODOLOGIES would be useful. 


This is a small percentage of our current ‘C’, 
our clients and requirements are generated on a 


opportunities exist for you, call:- 


SHERMAN MOSS 


GRAPHICS, ‘C’ C++ 
Surrey £15-25,000 
Due to expansion this highly successful, world 
leader in the areas of Image & Signal processing 
and high performance graphic systems, urgently 
Seek Software Engineers with a good appreciation 
of hardware design. 
Candidates will ideally be degree educated with 
one years expertence in some of the following:- 
‘C’, C++, low level programming, Occam, tmage 
processing and parallel processing. 
Enthusiasm and a commitment to succeed are 
pre-requisites. 


IMAGING SYSTEMS 

Berks to £29,000 
This highly successful, well established systems 
house currently seeks to recruit a Senior 
Analyst/Programmer. 

As a market leader tn the fleld of OCR/Data 
Capture and Imaging Systems, they are looking 
for someone fairly sentor with at least 18 months 
‘expertence of developing with Windows 3.0/SDK 
and some experience of project management. 
Ideally candidates will also have a degree and 
will have come from a FinanciaVD.1.P. 
background aged in their mid 20's to early 30's. 


BOSSINEY HOUSE, 15 BOSSINEY PLACE, MILTON KEYNES, BUCKS MK6 2EF. 


Tel: 0908-692633 / 0908-696334 


C++/MS-WINDOWS 
Thames Valley to £23,000 
Specialising in PC based Voice Network 
Management tools, our cient currently seeks to 
recruit a senior software engineer as a result of a 
major new product development, 
The client 1s looking for an experienced and 
talented software engineer with experience of C++ 
and/or ‘C’ programming, MS-WINDOWS and 
STRUCTURED METHODOLOGIES. 
Ideally candidates will also have worked on 
Database, Real-Time or Communications based 
applications. 


WINDOWS 3.0/SDK 

City £23,5000 
A major player in the rapidly expanding market 
of Imaging Systems, our client currently requires 
asentor programmer to aid in the development of 
thetr Image Management Tools. 

Candidates must have at least 18 months 
development experience using Windows 3./SDK 
together with knowledge of UNIX and/or PC 
Networking which would prove advantageous. 
An excellent opportunity to progress your career!! 


C++ and WINDOWS vacancies. These skills are constantly in demand by 
daily basis throughout the UK. For an up-to-date view of what 


-EXE RECRUITMENT ADVERTISING - Call Marc Warren on 081 994 6477 


MOTIF - XII - X-WINDOWS - UNIX 


CAMBS TO 254K + BENS 
One of the only truly innovative X-Windows Develop- 
ment Software Houses in looking for some 
development/support consultants. You should have 
good exposure to the Motif products and have at least 
a year’s experience; a relevant degree is not a 
necessity but could be useful. 


WINDOWS SDK - C - SQL 
ORACLE - RDBMS 


LEICS TO 25K 
Good Windows and OOP skills are the necessity with 
this role. Image processing software house with a view 
on many different platforms want a really good 
coder/developer who enjoys what he/she is doing. A 
good educational standard is required - a bright and 
numerate individual please. 


PRESENTATION MANAGER 


OS/2-C 

W.LONDON 20K + BENS 
A graduate Software Engineer is wanted for a heavy 
duty financially orientated development. You should 
have a thorough understanding or experience of the 
development lifecycle. Structured methodologies play 
an important part in this company’s programming 
strategy. 


DOS - OS/2 - WINDOWS 
UNIX - OSF MOTIF 
BERKS 18-25K + BENS 


A graduate is required with at least three years’ experi- 
ence in programming or on-line documentation 
technology, or one-line help systems. A self starter and 
a capable finisher is the kind of motivated individual re- 
quired. This company has a reputation second to none 
and as such would improve any professional coders 
Status instantaneously!! Oh, and any Hypertext experi- 
ence would be greatly received. 


SYBASE - C - X-WINDOWS 
CITY NEG + SUBSTANTIAL BENS 


This is a typically nineties cocktail; you must be a high 
calibre developer with a good degree. Some knowl- 
edge of Banking Systems or broking would be an 
advantage. Futures or Equities experience would be 
the icing on the cake. For the right person the remuner- 
ation package will most likely be exceptional. 


SMALLTALK - OOD - OOP -C 
LONDON/HOME COUNTIES 27K +CAR 


A platform independent development software house that 
has all the makings of doing extremely well: Quite a 
young company that requires a Coder/Developer with flair 
and ability. In profile you should be a second jobber with 
about two years’ development ability behind you. 


MS-WINDOWS - X-WINDOWS - C 
PC - UNIX 
N.LONDON/HERTS TO 30K + BENS 


Vertical market business/financial software house is 
looking for a systems/utility style programmer who can 
think both open Systems and networked PCs at the 
same time. You must be able to apply windows devel- 
opmentt skills to both platforms at any given moment: 
quite a challenging role for the right person; good ex- 
perience...... 


RUN TIME SYSTEMS - 8086/286 
DOS - OS/2 - UNIX 


BERKS 18-25k + BENS 
Windows, and C Coding as well? This company 
doesn’t want too much does it?! This development role 
is system programming in nature specifying, designing, 
coding and modifying products. Motivation is a prereq- 
uisite; experience of large systems development and a 
quality conscious attitude are all important traits. 


DIST/COOP PROCESSING 
3720 EMULATION 
MULTIPLE PLATFORMS 


BUCKS 35K 
GUI Front end development; in a fast path project, a 
blinding coder is required for all elements in develop- 
ment life cycle: preferred knowledge is DOS OS/2, C 
and Cobol and some experience of LU2/3270 emula- 
tion; graphical interfaces and Dialog systems - CICS or 
IMS 


COMPILER - RUN-TIME 
SYSTEMS - WINDOWS/NT 
BUCKS 18-25K 


A Cobol run-time is written in C; to address and exploit all 
32-Bit Operating Systems; such as Unix, OS/2 and Win- 
dows/NT. The job will involve all aspects of development, 
and cross platform consistency will be the ground rules; 
2-3 years’ systems programming experience on Unix, 
DOS, OS/2 or Windows is essential; and a creative ap- 
proach to problem solving - small team work...... 


DURNAN LINSTEAD & ASSOCIATES 
32 ST JAMES’ STREET, LONDON SW1A 1HT 


If any of the above vacancies do not quite suit you, why not give us a call and we might have just 
the right vacancy for you! For further information and applications, please call Mike Dearing or 
Simon Gudgeon on 071 321 2277, or after business hours and weekends on 0376 348469, alterna- 


tively fax your C.V. on 071 925 2150. 


ADVERTISERS INDEX 


ADVERTISER PRODUCT/SERVICE CIRCLE PAGE | ADVERTISER PRODUCT/SERVICE CIRCLE PAGE 
Admiral Application Bullder 399 49 | Protek! Programming Tools 37 7 
Bits per Second Graphics Tols 397 47__| Protekil Programming Tools 401 53 
Blink Inc. Clipper Fast Linker 400 50 | QA Training 415 IFC 
BL Computer Secur! Software Security Dongle 414 79 | QBSI Editor 375 14 
Brent Communications MAX Copy Protection 409 tal QBS II Clipper 395 44 
Contemporary BASIC Database 391 38 Rainbow Technologles Security Products 378 19 
CTL Copy Protection Hardware 410 71__| Readmar Version control 381 25 
Sareen Project Management 385 $2__| Richfords Tralnin 368 ui 
DES Software Protection 413 77 | Ridgeway Computer Manuals & Printing 387 35 
Ex | Programming Tools 382 26 _ | Salford Software Fortran for DOS & UNIX 376 15 
tl ramming Tools 402 55 _| Silica Systems| Hardware 373 ul 

Forté Software Tools Version Control 396 47 _| Silica Systems II Hardware 369 IBC 

Grey Matter ramming Tools 371 § SoftDev 92 Exhibition/Seminar 369 1243 
Gwi Software Design Tools ANG/7/8 37 __| Softlok Plracy Protection 412 75 
Inmark C++ Application Framework 419 OBC | Software Con Co.! Visual Basic 379 20 
Inn Data Development 392 40 | Software Con Co. It Programming Tools 406 65 
Inst. Analy mrs Institute - 408 71__ | Software Security Security Products 372 8 
Instrumatic C++ Development 388 35 | SystemC Application Generator 403 56 
Intasoft Software ManagementSystem 393 41 _ | System Science! Programming Tools 390 37 
LPA AV/KB/OOPS Software 386 $5 _ | System Science Il Programming Tools 407 67 
nifer Software Protection Device 394 43 | System Star! TBX Shield 380 23 
Microcosm Copy Control 411 va fem Star Il Programming Tools 384 31 
Microft Security Software 405 62 _| User Friend Software Copy Control 398 48 

Nu Mega Debugging Tools 383 29 | Zinc GUI Libr 
Poet/Object Oriented Database 370 2 


Shakespeare on Programming 


Wysiwyg has noticed some details in the Bard’s works which seem to have escaped all previous Lit Critters. 


Few people realise that, in addition to 
writing plays, William Shakespeare was an 
accomplished programmer and software 
beta-tester. His PC was configured ‘with all 
appliances and means to boot’ [Henry IV 2, 
III.1.29], and he also used a Macintosh, as 
evidenced by the remark, ‘What light 
through yonder window breaks? [Romeo 
and Juliet 11.2.1] - uttered before he found 
the brightness control. 

Structured programming was not Sha- 
kespeare’s forté, Troilus and Cressida, writ- 
ten in FORTRAN for a Japanese car firm, 
contains the regrettable line ‘Go to, go to!’ 
(II.2.53] as well as fifteen other go tos, two 
go froms, and the inevitable comment, ‘And 
whither go they?’ [1.2.2]. A similar comment, 
‘Stand not upon the order of your going / 
But go at once’ [Macbeth I11.4.29] clearly 
refers to a multi-level exit from deeply 
nested procedures. 

Shakespeare liked user-defined data 


types because, as he put it, ‘There are more 
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things in heaven and earth, Horatio, than 
are dreamt of in your philosophy’ [Hamlet 
15.166]. Elsewhere he asks, ‘Shall I com- 
pare thee to a summer’s day?’ [Sonnets 18.1] 
- an obvious type mismatch, which is why 
he ‘did never sonnet for her sake compile’ 
{Love’s Labour's Lost 1V.3.134). 

As a beta-tester for Borland, Shakes- 
peare cautioned Philippe Kahn, ‘Les lan- 
gues des hommes sont pleines de 
tromperies’ [Henry V, V.2.118], and advised 
him to bring out a fast, low-cost Pascal 
compiler, for ‘Iam as poor as Job, my lord, 
but not so patient’ [Henry IV 2, 1.2.145). 
Many early Borland products were based 
on Shakespeare’s suggestions, including 
SideKick (‘A calendar! a calendar!’ [Mid- 
summer Night’s Dream I1.1.55]) and Turbo 
Prolog (with ‘much virtue in "if”, As You 
Like It V.4.108). 

Shakespeare disparaged BASIC on the 
ground that its designers ‘have been at a 
great feast of languages, and stolen the 


scraps’ [Love’s Labour's Lost V.1.39], though 
exactly which SIGPLAN banquet he had in 
mind is not clear. He later wrote a book on 
Modula-2, Much Ado About Nothing, and a 
list of bugs in PC-DOS 3.2, the Comedy of 
Errors. In the latter he tells a programmer, 
‘We may pity, though not pardon thee’ 
(1.1,97]. Elsewhere he describes how DOS 
crashes with a stack overflow: ‘He dies, and 
makes no sign’ [Henry VI 2, III.3.29] and 
gives his advice to a colleague to whom this 
happened: ‘Boot, boot, Master Shallow’ 
libid., V.3.141). 


EXE. 


Wysiwig is a graduate of Cambridge 
University who was once left alone for an 
hourwith a Shakespeare concordance. This 
article first appeared inPC Techniques and 
is reprinted with permission. 

Verity Stob, who incidentally was from 
her mother’s womb / Untimely ripped, is on 
holiday. 


Ricoh UK Ltd is part of the worldwide Ricoh Group of companies, originally 
established in Japan, in 1936. With a turnover of over $5 billion and 37,000 
employees, Ricoh have been producing computers and peripherals since 1971 and 
are the world’s second largest manufacturer of Laser Printer engines. Ricoh have 
employed their expertise to produce a ‘first’ in laser printers for the world market, 
the LP1200 with FLASH ROM. 


ran HP LaserJet III™ compatible, the new LP1200 employs industry proven laser 
technology. Unlike LED page printers, which use light emitting diodes, the LP1200's 

teaee lightsource, focussed by high quality lenses, is able to produce the most 

accurate and intense printed images. It has 2Mb of RAM built-in and requires no 

additional RAM to print a full A4 page of graphics at 300dpi. Its fast, efficient 

processor and engine, together with a straight paper path design, allows 

printing at a full 6 pages per minute. Unlike its competitors, this advanced 

laser engine enables the LP1200 to address a range of print resolutions up 

to 400dpi. A special driver, combined with the 2mb RAM upgrade, enables 

the Ricoh LP1200 to print at 400dpi from Windows 3. 


Again, unlike the competition, the LP1200 includes a powerful 
document description language as standard. This language, 
‘LAYOUT’, offers unique opportunities to develop custom-made 
printing systems. Forms and document templates can be designed 
and stored electronically in the LP1200’s FLASH RO. 
alleviating the need for pre-printed forms! 


COMPUTER 
SHOPPER 


BEST BUY BEST BUY 


OCTOBER “92 AUGUST '92 


RICOH LP1200 


® 6 PAGES PER MINUTE 
Using a straight paper path 
: ®@ PCLS - mc HP-GL/2 


Z Latest version with scalable fonts 


®@ SHARP EDGED PRINTING 


Ricoh FIAL (Fine Image ALgorithm) enhances 
resolution 


© 400dpi RESOLUTION ‘esos ww a 
Default res - 300dpi. Will address 200, 240 & 400dpi. 


@ 2Mb RAM AS STANDARD 
For a full Ad page of graphics at 300dpi. 


@ UNIQUE FLASH ROM 


For controller upgrade and storage 


© IC CARD SLOT (renciceionconsiee) 
For programmable FLASH ROM cards 


@ EXPANSION BOARD SLOT 
For improved connectivity to additional 
systems eg. Coax/Twinax, PC-LAN etc 


@ LAYOUT 


Document Description Language 


@ SERIAL + PARALLEL PORTS 


For connection to PC compatibles and other computers 


@ 7 YEAR ON-SITE WARRANTY 


Next working day response 


UK choice 


OCTOBER ‘92 


SHOWN WITH. 
UNIVERSAL FEEDER 


TOP TRAY 
(OPTIONAL EXTRA) 


The Ricoh LP1200 is a genuine laser printer and not an 
LED printer. Make sure you check out the competition! 


See how the Ricoh LP1200 compares 
to its Laser Printer Competitors 


Hp LueT] MMAN | ipn1 4029) icon 

FEATURES eruatun | Tne | TALLY. Vout G10} CPt200 
Tverage Street Price (oxo. VAT) tono | —fo0o [699° 1699 
Official RRP (excl. VAT) £945 | £1,179 £1,099 £1,099 £1,195 | 
‘Maximum resolution in dots per inch 300x300 | 300x300 | 300x300 400 x 400 
Windows 3 Driver @ 400 dpi =O = [eeenee| YES. 
Print Speed éppm 
Straight Paper Path —_YE YES 
PCL 5 Printer Command Language 5 YES 
HP-GL/2 Vector Graphics included a YES 
5] YES 
Standard RAM. . 2Mb 
Full A4/300 dpi graphics with standard RAM | - YES 
Warm Up Time <45 sees | <60 secs 4 secs 
First Page of Text Output <20 secs | <40 secs <15 secs 
Document Description Language included YES 
Flash ROM, =! 
Upgradable Firmware 
1G Card Slot i 
Scalable Resident Fonts - in HP LJ Ill Emulation} _ 
Resident Bit-Mapped Fonts 
AGFA Intellifont Scalable Font Technology 
HP LaserJet Ill Emulation Included 
EPSON FX Emulation Included 


Silica Systems are pleased to introduce the revolutionary, new Ricoh LP 1200. It has all 
of the specifications that you would expect to see in feces most technically advanced 
laser printers, plus a unique additional feature which places it far ahead of the 
competition - FLASH ROM. This ‘Future Proof’ technology protects the investment you 
make when you buy a Ricoh LP1200, as it enables you to keep up to date with new 
laser firmware developments. FLASH ROM is an area of memory inside the LP1200 
which holds the printer's controller instruction firmware. If new firmware is developed, 
updated printer command languages etc, can be downloaded into this memory. Other 
manufacturers would require you to buy a new printer! Fonts, macros, graphics and 
additional emulations can also be stored in FLASH ROM, or on removable, industry 
standard FLASH ROM IC cards. The new Ricoh LP1200 is the only laser printer to 
offer this FLASH ROM facility. The LP1200 comes with a 100 sheet A4 paper tray and 
the facility to feed single sheets of paper and card up to 157gsm. An optional extra 
universal feeder provides the facility to feed up to 150 sheets, from a minimum size of 
98mm x 148mm to a maximum size of 216mm x 356mm at weights up to 158gsm, up to 
15 envelopes, overhead transparencies and 
labels automatically. 


Consumables + Accessories 


PRODUCT PRICE 


IBM ProPrinter Emulation Included 
Standard Tray Capacity 

Protective cover on standard tray 
Cost per copy** 

Min-Max Paper Weight in gsm 
Able to print on OHP Film 


Cable for PC/ST/Amiga 
Universal Feeder (2nd Tray)... 
2Mb RAM Module 


Developer/Toner Cartridge .. 


OPC Cartridge (Drum) 
Ad paper Tray (100 Sheets)... 


Exe VAT 
£8.47 
£100.00 


vs £149.00 


£65.00 
£89.00 
£35.00 


‘Able to print on card (1579sm - Manual Feed) 
Standby -Noise Level 
Printing -Noise Level 

As quid by manvhactrea 292 


CALL FOR A FULL PRICE LIST 


“Note: AA paper ay is ake9dy nuded Moo 
trays canbe urenased to foo erent costed sateray 


‘Al Trademarks are acknowledged 


MAIL ORDER: 1-4 The | Mews, Hatherley Rd, Sidcup, Kent, DA14 4DX Tel: 081-309 1117 
‘Order Linés Open: Mon-Sat 9,00am:6,00pr No Late Night Opening Fax No: 081-308 0608 


LONDON SHOP: 52 Tottenham Court Road, London, W1P OBA Tel: 071- 580, 4000 
‘Opening Hours: Mon-Sat 9.90am-6.00pm No Lato Night Opening Fax No; 071-323 4 


LONDON SHOP: Selfridges (ist Flot, Oxford Street, London, WiA 1AB Tel: ot i mE 
Opening Hours: __ Mon-Sat 9.30am-6.00p Late-Night: Thursday until 8pm Extension: 3 


SIDCUP. SHOP: 1-4 The | Mews, Hatherle Rd, Sidcup, Kent, DA14 4DX Tel: 18 302 8811 
‘Opening Hours: Mon-Sat 9.00am-5.30pr ight: Friday until 7pm Fax No: 081-309 0017 


FREE OVERNIGHT DELIVERY: On all hardware orders shipped in the UK mainland. 
TECHNICAL SUPPORT HELPLINE: Team of technical experts at your service. 
PRICE MATCH: We normally match competitors on a “Same product - Same price” basis. 
ESTABLISHED 14 YEARS: Proven track record in professional computer sales. 

£12 MILLION TURNOVER (with 60 staff): Solid, reliable and profitable. 

BUSINESS + EDUCATION + GOVERNMENT: Volume discounts available 081-308 0888. 
SHOWROOMS: Demonstration and training facilities at our London & Sidcup branches. 


TTo: Silica Systems, EXE-1092-75, 1-4 The Mews, Hatherley Rd, Sidcup, Kent, DA14 4Dx ) 
THE FULL STOCK RANGE: Allof your requirements from one supplier. 
FREE CATALOGUES; Will be mailed to you with offers + software and peripheral details. 


@ PAYMENT: Major credit cards, cash, cheque or monthly terms. | PLEASE SEND INFORMATION ON THE RICOH LP1200 | 


Before you decide when to buy your new laser printer, we suggest you think very carefully about | 


Mr/Mrs/Miss/Ms: Initials: 


. Surname: 


WHERE you buy it. Consider what it will be like a few months after you have made your purchase, when 
you may require additional peripherals or consumables, or help and advice with your new purchase. 


‘And, will the company you buy from contact you with details of new products? At Silica Systems, we | Company Name (if applicable): .... 


ensure that you will have nothing to worry about. We have been established for almost 14 years and, 
with our unrivalled experience and expertise, we can now claim to meet our customers’ requirements Address: ....... gabeabcive 
with an understanding which is second to none. But don't just take our word for it. Complete and return | 


the coupon now for our latest FREE literature and begin to experience the “Silica Systems Service”. 


SYSTEMS poles 
|_wnicn ec computer(s), it any, do you own?... 
ee ae a, 
ROE Adverinad pices and specications may change. Plone lutte coupon Toro flat loca, 


. Postcode: .. 
. Tel (Work): ..... 
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WINDOWS 3.X 


WINDOWS NT 


If you want an Application Framework that will 
simplify Windows programming, zApp is better 
than Borland’s OWL or Microsoft’s MFC. And 
zApp’s portability makes it the world class leader. 


OBJECTWINDOWS 
FOR CH 


zApp outclasses Borland. “zApp...implements 
the same general concepts as Borland’s Object Windows 
(Library), but takes them significantly further... 
The xApp class library is larger than OWL’s and 
much richer.” —Jeff Dunteman, PC Techniques. 
The zApp class library provides nearly 200 object 
classes for creating even sophisticated applications without hassling with the Windows API. OWL’s 50 
classes have such limited coverage that creating a basic “Hello World” application (Petzold’s Programming 
Windows) forces you to program the Windows API directly. zApp gives you a@// the classes you need. 


zApp outclasses Microsoft. “zApp’s model of Windows is not an object-oriented wrapper (as in 
Microsoft's Foundation Classes)... Rather, xApp offers the most comprehensive, object-oriented approach I’ve seen 
to Windows.” — Richard Hale Shaw, Windows Tech Journal. If you want an Application Framework to free 
you from grappling with the hard-to-use Windows API, zApp does it better than MFC. In fact, Richard 
Hale Shaw points out that MFC “might as well be Windows” and the MFC Users Guide even admits that 
it is “really a direct C++ wrapping of the familiar C functions for Windows” Because zApp presents a 
more powerful interface to Windows, zApp can reduce your code length by over 60% compared to MFC, 


zApp gives you portability that OWL and MFC don’t. With zApp, you can support multiple 
platforms today and know that your code will run on the platforms of tomorrow. zApp provides you with 
single source code compatibility between Windows"; Windows NT’ DOS, OS/2"\ and soon, X/Motif 


Sample zApp now. Call Systemstar on (0992) 500919 for a free zApp Demonstration Program 
and see zApp’s classes and several sample programs with source code. Better yet, try zApp with 
our 60-day unconditional money-back guarantee. You'll know a class act when you see one. 


UNIX X/MOTIF 
™ Graphics classes Advanced Message Robust and Efficiont 
include Window, Bitmap, Handling Memory Management FOR A 
Dinky and Meets Object Persistence Documentation including Li MITED 
Brushes, Bitmaps, Colors, High Level Printing gears ee rae 
Ee ops ae Pregame Reon: All 
Over 35 Window classes s order of zApp, we 
including fet Dialog, ‘Data Entry es. Dimonsioning classes eat pont! ua ee App 
MDI, All standard Controls, include Text, Picture String, including English, Metric, Borland, Microsoft and (with 
Common Dialogs, and access Numeric, Date, Time, Dialog Unit, Printer Point, Toreeht H 
to Custom Controls Radio Group, Checkbox, and Pica ; table 
Menus including standard, and List Fields. Advanced MDI Support Complete Source Code 3-1) controls, 
system, and popup Support for OLE and DDE Automated Window No Runtime Royalty 
Positioning requirements 


INMARK 2065 LANDINGS DRIVE, MOUNTAINVIEW, CA 94043 
All product names referenced herein are trademarks of their respective companies. 


aSYsTEMSTAR 


THE.RED HOUSE BLUECOATS HERTFORD SG14 1AX 
TELEPHONE: (0992) 500919 FACSIMILE: (0992) 554261 
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